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Note to all users: 


All options and values that were valid on the JCL EXEC statement, the IOCP 
command, and the menu screens in previous levels of IOCP are still valid. 


If your processor complex has only two I/O configuration data sets, the following 
changes apply throughout this manual: 


¢ There are only two I/O configuration data sets, the LVLO IOCDS and the LVL1 
IOCDS. When the manual refers to the AO IOCDS, this is the LVLO IOCDS; 
the Al IOCDS is the LVL1 IOCDS. Ignore all references to an A2, A3, and B 
side (BO, B1, B2, and B3) IOCDS and to any options that contain AB (such as 
WRTCDS= ABx). 


¢ JOCP can write only to the LVLI IOCDS. 


¢ You select the active IOCDS and do a power-on reset from the CONFIG 
(SYS020) frame. Action A3 on the CONFIG frame switches the LVLO and 
LVL1 IOCDS. Ignore all references to the IOCDSM (SYS021) frame. 


If your processor complex does not have a B side, ignore all references to the B side 
throughout the manual. This includes ignoring all references to: 


The BO, B1, B2, and B3 IOCDS 

Options that contain AB (such as WRTCDS = ABx) 

Processors | and 3 

Channel paths 40 through 47, 50 through 57, and 60 through 67 


ee © @ @ 


If you have a 3084 Processor Complex, it must be configured as a multiprocessor for 
the options that contain AB (for example REPORT = AB) to be executed. B side 
options cannot be executed on the A side of a physically partitioned 3084 Processor 
Complex; while A side options cannot be executed on the B side of a physically 
partitioned 3084 Processor Complex. 
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Preface 


This book describes the input/output configuration program (IOCP) used to define 
I/O configuration data required by the processor complex to control I/O requests. 
This book does not include information on how to configure I/O resources, only on 
how to define the configuration via IOCP. 


This book describes the MVS version, the VM version, and the stand-alone version 
of IOCP. The VM version of IOCP means that version of IOCP that runs under all 
releases of the following operating systems: VM/System Product (5664-167), 
VM/System Product High Performance Option (5664-173), and the VM/Extended 
Architecture Systems Facility (VM/XA) (5664-169). 


Trademarks 


The following are trademarks of International Business Machines Corporation. 


° MVS/SP™ 
° MVS/KA™ 
° VM/XA™ 


Who Should Read This Book 


This book is intended for system programmers and customer engineers who are 
responsible for defining, installing, and configuring the channels, control units, and 
I/O devices on the processor complexes listed on the cover of this manual. It 
assumes the reader has a knowledge of the appropriate processor complex and the 
characteristics of its I/O resources. 


Note that where the term “processor complex” appears in this manual, all the processor 
complexes listed on the cover are implied, unless an exception is explicitly made at that 
point in the text. The term “uniprocessor” in this manual refers to a processor 
complex that physically contains only one processor. 


How This Book Is Organized 


You will find the following topics presented in this book: 


Chapter 1. Introduction - presents an overview of the input/output configuration 
program (IOCP) and the I/O configuration process. 


Chapter 2. Executing the MVS Version of IOCP - describes how to code IOCP 
macro instructions and how to execute IOCP under control of the MVS system 
control program (MVS/370 or MVS/XA). 


Chapter 3. Executing the VM Version of IOCP - describes how to code IOCP macro 
instructions and how to execute IOCP under control of the VM/SP, the VM/SP 
High Performance Option or the VM/XA Systems Facility system control program. 


Chapter 4. Executing the Stand-Alone Version of IOCP - describes how to execute 
IOCP from the system console or the service support console. 
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Chapter 5. IOCP Configuration Reports - shows the configuration reports that IOCP 
produces. 


Chapter 6. IOCP Messages - lists the messages (prefix ICP and DMSICP) that IOCP 
issues. 


Appendix A. Coding IOCP Macro Instructions - describes the rules for coding IOCP 
macro instructions and the notation used in this book to illustrate the syntax of the 
macro instructions. 


Appendix B. Listings of Macro Instruction Input - shows sample listings of IOCP 
input decks. 


Appendix C. Characteristics of the I/O Interface Timeout Function - contains. detailed 
information about the timeout function. 


Appendix D. A Sample List of I/O Devices and Control Units - shows the IOCP 
parameter values that you specify on the IODEVICE and CNTLUNIT macro 
instructions. 


Glossary of Terms and Abbreviations - defines some terms and abbreviations used in 
this book. 


Where You Can Find Additional Information 


The following publications contain information for topics related to IOCP. 


Processor Complexes 


vi 


IBM System/370 Input/Output Configurator, GA22-7002, lists the devices available 
on the System/370 processors. 


IBM 3081 Functional Characteristics, GA22-7076, provides an overview of the 3081 
Processor Complex. 


IBM 3083 Functional Characteristics, GA22-7083, provides an overview of the 3083 
Processor Complex. 


IBM 3084 Functional Characteristics, GA22-7088, provides an overview of the 3084 
Processor Complex. 


IBM 3081 and 3083 Channel Characteristics and Configuration Guide, GA22-7077, 
provides information about channel operations and guidelines for configuring 
channel loads. 7 


IBM 3081 Operator’s Guide for the System Console, GC38-0034, describes how to 
operate the 3081 Processor Complex. 


IBM 3083 Operator's Guide for the System Console, GC38-0036, describes how to 
operate the 3083 Processor Complex. 


IBM 3084 Operator's Guide for the System Console, GC38-0037, describes how to 
operate the 3084 Processor Complex. 
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MVS/370 


MVS/XA 


IBM 3081, 3083 , and 3084 Messages for the System Console, GC38-0035, lists and 
defines the messages that are displayed during operation of the system console. 


IBM 9081 and 9083 RPQ Information Supplement, GL22-7086, is a supplement for 
the 9081 and 9083 Processor Complexes to [BM 3083 Functional Characteristics and 
IBM 3081 and 3083 Channel Characteristics and Configuration Guide. 


IBM 9081 and 9083 RPQ Operator Information Supplement, GL22-7087, is a 
supplement for the 9081 and 9083 Processor Complexes to IBM 3083 Operator's 
Guide for System Console and IBM 3081, 3083 and 3084 Messages for System 
Console . 


OS/VS2 MVS/System Product General Information Manual, GC28-1025, describes 
the MVS system requirements for MVS/System Product Version | (Program 
Numbers 5740-XYS and 5740-XYN). 


OS/VS2 System Programming Library: System Generation Reference, GC26-3792, 
provides information necessary to install an MVS/370 system control program. 


OS/VS2 MVS JCL, GC28-0692, contains the information necessary to code 
MVS/370 job control language statements. 


MVS/System Product Version 2 Release 1 General Information, GC28-1118, describes 
the MVS system requirements for MVS/System Product Version 2 (Program 
Numbers 5740-XC6 and 5665-291). 


MVS/System Product Version 2 Release 2 General Information, GC28-1500, describes 
the MVS system requirements for MVS/System Product Version 2 (Program 
Numbers 5740-XC6 and 5665-291). 


Data Facility Product: General Information, GC26-4142, (Program Number 
5665-0284) describes the system generation requirements for MVS/System Product 
Version 2. 


MVS/Extended Architecture Installation: System Generation, GC26-4148, provides 
information necessary to install an MVS/XA system control program. 


MVS/Extended Architecture: MVS Configuration Program Guide and Reference, 
GC28-1335, provides information necessary to use the MVS configuration program 
for releases of MVS/SP 2.2.0. 


MVS/Extended Architecture JCL Reference, GC28-1352, contains the information 
necessary to code MVS/XA job control language statements. 


MVS/Extended Architecture JCL User's Guide, GC28-1351, describes the job control 
tasks needed to enter jobs into the operating system. 
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VM/SP 


IBM Virtual Machine/System Product General Information, GC20-1838, describes the 
features of the IBM Virtual Machine/System Product (VM/SP) Program Product 
and includes a list of devices supported by VM/SP. 


IBM Virtual Machine/System Product: Planning Guide and Reference, SC19-6201, 
describes information about generating a VM/SP system on a processor complex. 


IBM Virtual Machine/System Product: Installation Guide SC24-5237, provides 
procedural information about the VM/SP installation process. 


IBM Virtual Machine/System Product: System Programmer's Guide, SC19-6203, 
describes the DIAGNOSE X‘80’ instruction, which is the CP (control program) 
interface that allows you to read from and write to the I/O configuration data sets in 
the processor controller, 


VM/SP High Performance Option (VM/SP HPO) 


IBM Virtual Machine/System Product High Performance Option General Information 
Manual, GC19-6221, _ describes the features of the VM/SP HPO Program Product 
and includes a list of devices supported by VM/SP HPO. 


IBM Virtual Machine/System Product High Performance Option: Planning and 
System Generation Guide, SC19-6223, describes information about generating a 
VM/SP HPO system on a processor complex. 


IBM Virtual Machine/System Product High Performance Option: System 
Programmer's Guide, SC19-6224, describes the DIAGNOSE X‘80’ instruction, which 
is the CP (control program) interface that allows you to read from and write to the 
I/O configuration data sets in the processor controller. 


VM/XA Systems Facility 


Virtual Machine/Extended Architecture Systems Facility General Information Manual, 
GC19-6213, describes the features of the VM/XA Systems Facility. 


Virtual Machine/Extended Architecture Systems Facility: Installation, Administration, 
and Service, GC19-6217, describes information about generating a VM/XA system 
on a processor complex. 


Do You Have Problems, Comments, or Suggestions? 


Your suggestions and ideas can contribute to the quality and the usability of this 
book. If you have problems using this book, or if you have suggestions for 
improving it, complete and mail the Reader’s Comment Form found at the back of 
the book. 
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Summary of Changes 


Summary of Changes 
for GC28-1027-7 


This book incorporates changes that support control units capable of running at 4.5 
megabytes. 


Summary of Changes 

for GC28-1027-6 

This book incorporates two new options for the IOCP Command which include: 
¢ The WRTABx write option for generating an IOCDS. 

¢ The RPTAB option for producing configuration reports. 

The book also incorporates changes due to the MVS Configuration Program 


(MVSCP). MVSCP replaces the SYSGEN process in releases of MVS SP 2.2.0 or 
later. 


There are also minor technical and editorial changes. 


Summary of Changes 
for GC28-1027-5 


Changes throughout this publication describe a new level of the input/output 
configuration program (IOCP) to support: 


¢ A change in the VM IOCP command. The VM IOCP command now supports a 
processor option. 


e An added step for starting the stand-alone version of IOCP. 


There are also minor technical and editorial changes. 


© Copyright IBM Corp. 1980, 1989 Summary of Changes XV 


XVi IOCP User’s Guide and Reference » 


Chapter 1. Introduction 


In the processor complex! the channel subsystem, which controls channel operations, 
requires specific data about the hardware I/O configuration. 


To define the I/O configuration for the channel subsystem, you execute the 
input/output configuration program (IOCP). Required in this definition are the: 


e Channel paths on the processor complex 
¢ Control units attached to the channel paths 
e I/O devices assigned to the control units 


To meet your changing I/O requirements, you can replace an existing I/O 
configuration with a new configuration by executing IOCP. 


Figure 1-1 and Figure 1-2 show the processors and clwnnel paths that are available 
on each side of a processor complex. All of the processor complexes have side A. 
Side A may consist of processors 0 and 2 and channel paths 00 through 07, 10 
through 17, and 20 through 27. (A uniprocessor has only processor 2.) If the 
processor complex has both side A and side B, side B consists of processors | and 3 
and channel paths 40 through 47, 50 through 57, and 60 through 67. 


The control units and I/O devices attached to the channel paths complete the 
channel subsystem. You must use IOCP to define all control units and I/O devices 
that attach to the processor complex. 


See the JBM System/370 Input/Output Configurator for the control units and I/O 
devices available. Your operating system may not support all the devices IOCP 
supports. 


This chapter presents an overview of the following topics: 


¢ J/O configuration process 

¢ Input/output configuration data set TOCDS) 

¢ IOCP changes for 370-XA mode 

¢ Versions of IOCP (MVS, VM,? and stand-alone) 


1 Note that where the term “processor complex” appears in this manual, the term implies all the processor complexes 
listed on the cover of this manual, unless at that point, the text makes an explicit exception. 


2 “The VM version of IOCP” means that version of IOCP that runs under all releases of the following operating 
systems: VM/System Product (5664-167), VM/System Product High Performance Option (5664-173), and the 
VM/Extended Architecture (VM/XA) Systems Facility (5664-169). 
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Figure 1-1. Channel Path Configuration for a non-3084 Processor Complex 
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1/O Configuration Process 


You specify I/O configuration data to IOCP in either of two ways: coding the data 
on card-image macro instructions read from an input device, or entering the data 
from the system console or service support console. In either situation, IOCP 
performs the same process to build a configuration definition in storage and to write 
reports. IOCP stores the data in an input/output configuration data set JOCDS) on 
the processor controller file in the processor controller for use by the channel 
subsystem. 


Card- one input to IOCP 


You code the following card-image macro instructions and use them to define your 
- J/Oconfiguration data when you execute (1) the MVS version of IOCP, (2) the VM 
version of IOCP, or (3) the stand-alone version of IOCP with the card-image option. 
When IOCP processes these macro instructions, it also produces reports that allow 
you to check the configuration. 


Macro Instruction Description 


ID An optional macro instruction that specifies identification 
. information printed in the heading of IOCP configuration 
reports. It is also the source of the customer name for the 

IOCDS on the IOCDSM frame. 


CHPID A required macro instruction that specifies the channel paths 
installed on the processor complex. 


CNTLUNIT A required macro instruction that specifies the control units 
attached to channel paths. 


IODEVICE A required macro instruction that specifies the I/O devices 
assigned to control units. 


“Specifying IOCP Macro Instructions” in Chapter 2 (MVS) and Chapter 3 (VM) 
fully describes the IOCP macro instructions 


Console : hapuit to lIOCP 
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When you execute the stand-alone version of IOCP, IOCP displays menus on the 
display screen of the system console or the service support console. On the screen, 
you enter I/O configuration data and IOCP screen commands to control the 
functions of IOCP. For a full description of the stand-alone version of IOCP, see 
“Chapter 4. Executing the Stand-Alone Version of IOCP”. 
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I/O Configuration Data Sets 


Each side of the processor complex has four input/output configuration data sets for 
storing I/O configuration data. On the A side, the IOCDS names are AO, Al, A2, 
and A3. On the B side, the IOCDS names are BO, Bl, B2, and B3. The data sets 
reside on an integrated processor controller file in the processor complex. Each 
IOCDS consists of 256-byte records (sectors) containing I/O configuration data. The 
channel subsystem uses the I/O configuration data to control I/O requests. Each 
side provides four I/O configuration data sets to allow you to define and test new 
configurations without affecting an existing configuration. 


IOCP processes your definitions of channel paths, control units, and I/O devices in a 
working area of main storage named IOCDS. When you request, and if IOCP has 
found no errors, [OCP writes the IOCDS generated in storage to an IOCDS in the 
processor controller. 


IOCP accesses and transforms the configuration data in the IOCDS to a data format 
that the microcode in the channel subsystem uses when you perform either of the 
following actions: 


¢ A power-on reset -- action A2 on the CONFIG (SYS020) frame 


¢ The SYSIML CLEAR function -- action O8 on the OPRCTL (CC-010 or 
CC/010) frame 


(For more information, see the operator’s guide for the system console that applies 
to your processor complex.) The channel subsystem controls I/O requests using the 
configuration data from the IOCDS specified for the power-on reset. 


IOCP can read from any IOCDS (for example, to produce reports). However, LOCP 
can write only to an IOCDS not write-protected. 


You can write-protect each IOCDS individually by using the IOCDSM (SYS021) 
frame. This restriction prevents you from accidentally using IOCP to write over and 
destroy the configuration data in an IOCDS. Before writing an IOCDS, you must 
use the IOCDSM frame and remove the write protection from that IOCDS. (For 
more information, see the operator’s guide for the system console that applies to 
your processor complex.) 


When defining a new configuration, you can: 
e¢ Use the configuration in an existing IOCDS as your operating configuration. 
e Execute IOCP to generate and write a new I/O configuration to another IOCDS. 
¢ Perform a power-on reset and use the new configuration to test the system. 
¢ After successful testing, you can write-protect the new IOCDS by using the 


IOCDSM (SYS021) frame. 


If your processor complex has only two I/O configuration data sets (LVLO and 
LVLI1), switch the LVLO and LVL1 IOCDS after successful testing by using the 
CONFIG (SYS020) frame. The newly tested configuration now resides in the LVLO 
IOCDS and the previous configuration resides in the LVL1 IOCDS. The LVLI1 
IOCDS provides a backup. You can use the LVL1 IOCDS to test another new 
configuration. 
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Notes: 


1. If you partition a processor complex with an A and B side, you can use an 
IOCDS that has I/O configuration data for both the A and B sides. However, 
the processors cannot access control units and devices attached only to channel 
paths on the other side. 


to 


. If available during the installation of the new processor complex, the CE uses a 
card-image input deck containing [OCP macro instructions (prepared and 
checked by the installation) to configure the processor complex. The CE then 
tests the processor complex using the configuration supplied by the installation. 
The methods of execution in Chapter 2 (MVS), Chapter 3 (VM), and Chapter 4 
(stand-alone) describe the steps that the CE and the installation perform to 
define configuration data. 


3. If your processor complex has an A and B side, you should define critical 
configurations on both A and B side IOCDS(s). : 


Levels of the IOCDS 
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The processor complex can operate in either 370 mode or 370-XA mode. You select 
the mode on the CONFIG (SYS020) frame. Power-on reset sets the mode. 


In 370 mode, the processor complex operates in accordance with System/370 
architecture, the hardware architecture that the processor complex shares with other 
IBM processors, such as the IBM 303x processors and the IBM 4300 processors. 
One major characteristic of 370 mode is 24-bit addressing. 


In 370-XA mode, the processor complex operates in accordance with System/370 
Extended Architecture. Two main characteristics of 370-XA mode are 31-bit 
addressing and the use of a channel subsystem to direct the flow of information 
between I/O devices and main storage. 


This book describes the 370/370-XA level of IOCP, which creates an IOCDS that 
either 370 mode or 370-XA mode can use (a 370/370-XA IOCDS). Some previous 
levels of IOCP (370 IOCP) created an IOCDS for use only in 370 mode (a 370 
IOCDS). A 370/370-XA IOCP creates a 370/370-XA IOCDS regardless of the mode 
of the processor complex at power-on reset. 


A processor complex can use a 370/370-XA IOCDS in either 370 mode or 370-XA 
mode. If you do not specify the channel number and channel set for a channel path 
on the CHPID macro instruction, the processor complex cannot access the devices 
on that channel path when operating in 370 mode. 


Most of the information on the IOCP macro instructions applies to both 370 mode 
and 370-XA mode. When the processor complex operates in 370-XA mode, it 
ignores information valid only for 370 mode. Similarly, when the processor complex 
operates in 370 mode, it ignores information valid only for 370-XA mode. 
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Compatibility Considerations 


Before you can initialize a processor complex (by a power-on reset) in 370-XA mode, 
IOCP must generate a 370/370-XA IOCDS. The IOCP generation process requires 
as input an I/O configuration deck containing IOCP macro instructions. (You can 
use a combined input deck containing both IOCP, MVS system generation macro 
instructions and MVS Configuration program (MVSCP) macro instructions. None 
of IBM’s VM operating systems allow a combined deck.) To generate a 370/370-XA 
IOCDS, you can use the 370/370-XA level of the stand-alone version of IOCP. You 
can also generate a 370/370-XA IOCDS by running the 370/370-XA level of IOCP 
under the control of MVS/370, MVS/XA, VM/SP, VM/SP HPO, or the VM/XA 
Systems Facility. 


A 370 IOCDS does not support the operation of a processor complex in 370-XA 
mode. You cannot use a 370 level IOCP to read or produce reports of a 
370/370-XA IOCDS. (You also cannot use an older level 370/370-XA IOCP to read 
or produce reports of a 370/370-XA IOCDS produced by a newer level 370/370-XA 
IOCP.) If you attempt this operation, the system issues message ICP404], indicating 
that the level of the IOCDS directory is invalid. 


Note: I/O configurations that are valid in 370 mode may be invalid in 370-XA 
mode. It is important to fully understand the concepts and requirements of logical 
control units. If the requirements for logical control units have not been met, it may 
be necessary to physically reconfigure a system. You must review the current 
configuration to insure that the configuration is valid for 370-XA mode. This is 
necessary even when running in 370 mode. 
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370-XA Mode 


Notes 


To create a 370/370-XA level IOCDS, you can use without change macro 
instructions coded to create a 370 level IOCDS. MVS/XA or the VM/XA Systems 
Facility might not support all of the defined devices. See MVS/Extended 
Architecture System Generation Reference, MVS/Extended Architecture: MVS 
Configuration Program Guide and Reference or the Virtual Machine/Extended 
Architecture Systems Facility: Installation, Administration and Service. Although you 
can use the same macro instructions, you might consider making. the following 
changes: | - 


If there are channel paths and attached devices that you want to access only in 
370-XA mode, remove the channel number and channel set for those channel 
paths from the CHPID macro instruction(s). IOCP requires a channel number 
and channel set only if you will access the channel path and its attached devices 
in 370 mode. | 


To use the preferred path in 370-XA mode, code the PATH parameter on the 
IODEVICE macro instruction. The channel subsystem attempts to use the 
preferred path to initiate I/O requests. The PATH parameter is optional and 
applies only to 370-XA mode. The processor complex ignores the preferred path 
in 370 mode. 


You can use, without change, the macro instructions coded for the 370 level of 
IOCP to create an IOCDS for 370-XA mode operation. However, you must 
generate a new 370/370-XA IOCDS (with a 370/370-XA level of IOCP) before a 
processor complex can operate in 370-XA mode. 


For an MVS/370 system generation if you specified the PATH or UNITADD 
parameter the IODEVICE macro instruction, you cannot use a combined input 
deck (IOCP and MVS system generation macro instructions). 


If you use the PATH parameter or the UNITADD parameter on an IODEVICE 
macro instruction, you must use a 370/370-XA IOCP to test an IOCP input deck 
in 370 mode. 


MVS/370, VM/SP, and VM/SP HPO do not support operation of the processor 
complex in 370-XA mode. 


The 370/370-XA IOCP produces reports that are different from the reports produced 
by a 370 IOCP. Some of the new terms that appear in the reports and that 370-XA 
mode uses are: 


Logical control units 
Preferred path 
Rotation algorithm 
Device number 
Control unit type 
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Logical Control Units 
For 370-XA mode, the channel subsystem uses logical control units to represent a set 
of physical control units that physically or logically attach I/O devices in common. 
For example, the channel subsystem uses the logical control unit to establish a queue 
for I/O requests for the devices associated with the attaching physical control units 
and to establish a channel path selection order for the attaching channel paths. 


IOCP builds logical control units from the information specified on the CNTLUNIT 
macro instructions. If a device attaches to more than one physical control unit, then 
those control units will form part of (or the whole of) a logical control unit. IOCP 
builds a logical control unit for: 


¢ Each contro! unit with no devices or no devices shared with other control units. 


Note: Logical control units with no devices are listed at the end of the logical 
control unit report. The user should verify that the report accurately describes 
the user’s configuration. 


e¢ Each group of two to four control units that share devices between them. 
As it builds each logical control unit, IOCP assigns a unique hexadecimal identifier 


to the logical control unit. It also ensures that the logical control unit is valid, that 
it does not violate any of the following restrictions: 


¢ Maximum of four channel paths per system can attach to one logical control 
unit. 


e Each occurrence of a channel path counts as one channel path. 
¢ Maximum of four physical control units in one logical control unit. 
e A physical control unit can belong to only one logical control unit. 


e Physical control units within a logical control unit must all have the same 
characteristics (SSHARED=Y, YB, or N; PROTOCL=D, §, or S4). 


¢ Maximum of 256 logical control units per system. 


Figure 1-3 shows examples of valid logical control units. 
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Figure 1-3. Valid Logical Control Units 
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Figure 1-4 shows examples of invalid logical control units. 


Logical control unit 5 is invalid because the control units have a combined total of 
more than four channel paths. Logical control unit 3 in Figure 1-3 would become 
invalid if you attached another physical control unit to any of the devices in the 
logical control unit. 


Logical control unit 6 is invalid also because the combined total of channel paths is 
six and the maximum permitted is four. (Each occurrence of a channel path counts 
as one channel path.) 


The logical control unit report (See “Chapter 5. IOCP Configuration Reports”) 


describes the logical control unit structure. If it detects any invalid logical control 
units, IOCP issues error messages. 
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Figure 1-4. ‘Invalid Logical Control Units 
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Channel Path Selection 


Preferred Path 


In 370-XA mode, the channel subsystem attempts to use the preferred path, if 
specified, for the initiation of I/O requests. If the preferred path is busy or is not 
specified, the channel subsystem uses the rotation algorithm (for the associated 
logical control unit) to initiate I/O requests. 


The optional PATH parameter on the IODEVICE macro instruction and the ADD 
and the ALTER I/O device screens allows you to specify a preferred path for 
370-XA mode. When the processor complex is operating in 370 mode, the channel 
subsystem ignores the preferred path. When the processor complex is operating in 
370-XA mode, the channel subsystem attempts to use the preferred path to initiate 
I/O requests. The channel subsystem tries to initiate every I/O request for the 
desired device using the preferred channel path first (before it attempts to initiate the 
request on other attaching channel paths, if any exist). 


If the channel subsystem cannot initiate the I/O request on the preferred path either 
because of a busy condition or because the channel path, control unit, or device is 
already known to be busy, the channel subsystem tries to initiate the request on the 
other attaching channel paths. 


If no preferred channel path is specified, the channel subsystem uses the rotation 
algorithm to initiate I/O requests associated with the device’s logical control unit. 
The channel subsystem attempts to initiate each new I/O request using a channel 
path rotation algorithm. For example, if you attach a device to four channel paths, 
the channel subsystem tries to initiate the first I/O request on the first channel path, 
the second request on the second channel path, the fifth request on the first channel 
path, and so forth. 


The preferred channel path parameter is useful in controlling the path selection logic 
of the channel subsystem to minimize contention for a device. For example, 
consider the following configuration: 


¢ Two strings of DASDs (0-7 and 8-F), each attached to two 3830 control units (A 
and B). 


¢ Control unit A attaches to channel path 01 and control unit B attaches to 
channel path 02. 


In this configuration, the channel subsystem is capable of initiating 1/O requests to 
any of the devices from either of the two attaching channel paths. You can use the 
preferred path to minimize string busy conditions that the channel subsystem might 
encounter as it tries to initiate requests for the devices. By defining each string of 
devices with a different preferred channel path (for devices 0-7, specify PATH =01; 
for devices 8-F, specify PATH =02), you minimize the device busy conditions. 
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Rotation Algorithm , 
Each logical control unit has one to four channel paths. IOCP establishes a channel 
path rotation order for the initiation of I/O requests when the processor is operating 
in 370-XA mode. You can affect the rotation by changing the order of the channel 
path identifiers on the CNTLUNIT macro instructions. , 


_ To establish the rotation order, IOCP checks the control units within the logical 
control unit in ascending order of control unit numbers (specified on the 
CNTLUNIT macro instructions). IOCP takes the first user-entered channel path 
(on the CNTLUNIT macro instruction) from each control unit. IOCP then 
repeatedly checks the control units in ascending order. Each time, IOCP takes the 
next user-entered channel path, if there is one, until it orders all the channel paths in 
the logical control unit. 


Logical control unit 2 in Figure 1-3 shows an example of how specifying the paths 
in a logical control unit can affect the path rotation order. If you specify 

PATH = (01,07) on the CNTLUNIT macro instruction for physical control unit 2, 

and PATH = (02,04) for physical control unit 3, the rotation order is 01, 02, 07, 04. 
However, if you specify PATH = (07,01) on the CNTLUNIT macro instruction for 
control unit 2, and PATH = (02,04) for control unit 3, the rotation order is 07, 02, 

01, 04. 


The channel subsystem attempts to initiate each new I/O request on a rotating 
channel path basis. If a device has a preferred path, the channel subsystem always 
tries the preferred path first, the channel path following the preferred path in the 
rotation order next, and so forth. 


If a device does not have a preferred path, the channel subsystem first tries the next 
channel path in the rotation order following the last channel path used for an I/O 
request to a device in that logical control unit. If the first channel path tried is busy, 
the channel subsystem continues in the established rotation order. 


Note: The same channel path connected to more than one control unit in the same 
logical control unit, appears only once in the rotation order. IOCP removes 
duplicate channel path identifiers from the logical control unit provided that the 
total number was 4 or less. 


Channel Path Selection on a 3084 Processor Complex 
On a 3084 Processor Complex with both sides configured, each side has its own 
rotation algorithm for channel path selection. Figure 1-5 shows an example of a 
device attached to two control units, with each control unit attached to a channel 
path on both the A side and the B side. If you specify PATH = (02,42) on the 
CNTLUNIT macro instruction for control unit 13, and PATH = (12,52) for control 
unit 14, the rotation order in the IOCDS for the logical control unit is 02, 12, 42, 52. 
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Figure 1-5. Channel Path Selection on a 3084 Processor Complex 


If the device does not have a preferred path, or if the preferred path is busy, the 
channel subsystem tries the next channel path in the rotation order (for the logical 
control unit) that is on the side on which it attempts to initiate the I/O request. If 
the last channel path used is 02 on the A side and 42 on the B side, then 12 is the 
next channel path tried on the A side and 52 is the next channel path tried on the B 
side. It is unpredictable whether the channel subsystem will try channel path 12 or 
52 next. It is even possible that the channel subsystem will try channel path 52, and 
then 42 next (before channel path 12) because the two sides are independent in their 
selection of channel paths. 


In 370 mode, a device address consists of three hexadecimal digits that uniquely — 
identify an I/O device. (The device address is assigned in the ADDRESS parameter 
on the IODEVICE macro instruction and is a term used in 370 mode. The term 
device number is used in 370-XA mode.) The first digit of the device address must 
specify the channel number that corresponds to the lowest-numbered channel path 
assigned to the device (370-XA mode does not have this requirement). This channel 
path is the primary channel address for the device. The second and third digits 
specify the physical unit address of the device. 
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Device Number 


In 370-XA mode, a device number uniquely identifies an I/O device. (The device 
number is assigned in the ADDRESS parameter on the IODEVICE macro 
instruction.) The device number consists of three hexadecimal digits that can be the 
same as the device address used in 370 mode. If you want to use the IOCDS only in 
370-XA mode, you can choose the first digit of the device number arbitrarily, with 
the exception that MVS requires that the first digit must be the same for each device 
on a single control.unit or for each DASD on a single string. The second and third 
digits are the physical unit address. If you want to use the same IOCDS for both 
370 mode and 370-XA mode operation, you must specify the device numbers for 
370-XA mode the same way you specify device addresses for 370 mode. 


‘When defining an I/O configuration for 370-XA mode with a large number of 1/0 


devices, there may be situations when it is difficult or undesirable to assign device 


numbers that contain the physical unit address of the device. You may find it is 


necessary to assign the same unit address to more than 16 devices each on a separate 
channel path. However, this is not possible using only the ADDRESS parameter 
because you are limited to one hexadecimal digit and device numbers must be 
unique.) For example, you wish to assign the unit address ‘FO’ to 20 devices. The 
devices would have the device numbers as follows: IFO, 2F0, 3FO ..... FFO (the 
sixteenth device). The remainder of the devices would have duplicate device numbers 
which is not permitted (device numbers must be unique). 


When this occurs, you may want to use the UNITADD parameter on the 
IODEVICE macro instruction. 


UNITADD is an optional parameter that allows you to assign a device number in 
the ADDRESS parameter on the IODEVICE macro instruction that does not have 
the actual physical unit address of the I/O device as the two rightmost digits of the 
device number. (The device number is the three hexadecimal digits specified in the 
ADDRESS parameter.) The channel subsystem uses the two hexadecimal digits that 
you specify on the UNITADD parameter to address the device rather than the unit 
address specified in the ADDRESS parameter. When you use the UNITADD 
parameter on the IODEVICE macro instruction the unit address (the two rightmost 
digits in the ADDRESS parameter) is not required to be the physical unit address. 
Because the channel subsystem uses the two digits specified in the UNITADD 
parameter to address the device, these two hexadecimal digits must be the the 
physical unit address of the I/O device. 


Specify the UNITADD parameter on the IODEVICE macro instruction only for an 
IOCDS used exclusively for 370-XA mode operation. If you use the UNITADD 
parameter to create an IOCDS for both 370 mode and 370-XA mode operation, the 
device number for 370-XA mode will not be the same as the device address for 370 
mode. They are not the same because the two hexadecimal digits you specify on the 
UNITADD parameter become the second and third digits of the device address. 
(The second and third digits of the device address must be the physical unit address 
of the device.) 


Use the UNITADD parameter carefully. See Appendix D for the exceptions and 
recommendations that apply to specific device types. 
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Notes: 


1. The device number is always the three hexadecimal digits that you specify in the 
ADDRESS parameter of the IODEVICE macro instruction in 370-KA mode. 
(The UNITADD parameter does not change the device number.) 


2. If you specify the UNITADD parameter on the IODEVICE macro instruction, 
these two digits become the physical unit address that the channel uses to 
address the selected control unit in both 370 mode and 370-XA mode. 


3. If you use the UNITADD parameter on the IODEVICE macro instruction when 
you are operating in 370 mode the two digits specified in the UNITADD 
parameter replace the two rightmost digits specified in the ADDRESS parameter 
as the physical unit address. The UNITADD parameter on the IODEVICE 
macro instruction changes the device address. This changing of the device 
address (370 mode) could result in operational and serviceability problems. 


Control Unit Types 
When defining a 370 mode I/O configuration, you use the SHARED parameter on 
the CNTLUNIT macro instruction to indicate whether the control unit allows 
shared or nonshared subchannels. With 370-XA architecture, shared subchannels do 
not exist. Every device has its own subchannel. 


For 370-XA mode, IOCP defines control units as type 1 or type 2. Type 1 control 
units allow only a single channel program at any one time. Type 2 control units 
allow multiple channel programs concurrently. IOCP uses the SHARED parameter 
to determine the control unit type as follows: 


e Ifthe user specifies SHARED = Y or SHARED = YB, IOCP defines the control 
unit as type 1. The channel subsystem supports only one I/O request at a time 
(serializes). 


¢ Ifthe user specifies SHARED =N, IOCP assigns the control unit as type 2. The 
channel subsystem supports multiple requests. 


You specify the SHARED parameter in the same way for both 370 mode and 
370-XA mode. 


Note: The processor complexes listed on the cover of this manual define control 
units as only type 1 and type 2. The processor complexes treat a type 3 control unit 
as a type |. To define a type 3 control unit, specify SHARED = YB for 370 mode 
and SHARED = Y or SHARED = YB for 370-XA mode. [BM System/360 and 
System/370 I/O Interface Channel to Control Unit Original Equipment Manufacturer's 
Information, GA22-6974 define control unit types. 
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Versions of lIOCP 


There are three versions of IOCP: the MVS version, the VM version, and the 
stand-alone version. 


Overview of the MVS Version of IOCP 


The MVS version of IOCP runs as a job under control of MVS (MVS/370 or 
MVS/XA). 


You invoke the MVS version of IOCP via MVS JCL statements. By coding options 
on the PARM parameter of the EXEC statement, you can request the following 
IOCP functions: 


¢ Generating an IOCDS -- IOCP reads, validates, and checks the syntax of the 
input macro instructions. It generates an IOCDS in storage based on the 
configuration defined on the macro instructions and produces reports of the 
IOCDS generated in storage. When requested, IOCP writes the generated 
IOCDS to one or more IOCDS(s) in the processor controller. 


¢ Producing Configuration Reports -- IOCP reads one or more IOCDS(s) from the 
processor controller into storage and prints the IOCP configuration reports. 
(See “Chapter 5. IOCP Configuration Reports” for examples.) 


The MVS version of IOCP has an advantage over the stand-alone version; you may 
modify an IOCDS while other system operations continue. Then, at a convenient 
time, shut down MVS, power-on reset the processor complex with the new IOCDS, 
and re-load MVS. This method minimizes the amount of time that the system must 
be inactive while you reconfigure the I/O devices. 


See “Chapter 2. Executing the MVS Version of IOCP” for a full description of the 
MVS version of IOCP. 


IOCP and MVS System Generation 
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For an MVS (MVS/370 or a release of MVS/XA prior to MVS/SP 2.2.0) system 
generation, we recommend that you combine the IOCP and MVS system generation 
macro instructions to form one combined input deck for use by both IOCP and 
MVS system generation. One combined input deck ensures that the definitions of 
your software and hardware I/O configurations are identical for a processor 
complex. 


Installations using MVS/SP 2.2.0 or subsequent releases will use the MVS 
Configuration Program to perform the system generation function. 


IOCP processes the IOCP macro instructions (ID, CHPID, and CNTLUNIT) and 
the IOCP-related parameters on the IODEVICE macro instructions to define the 
hardware I/O configuration. The macro instructions that MVS system generation 
processes to define the software depends on whether it is an MVS/370 system 
generation or an MVS/XA (releases prior to MVS/SP 2.2.0) system generation. 
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Summary of MVS/370 System Generation 
The following is a summary of the MVS/370 system generation macro instructions 
and the processing for a combined deck: 


¢ The IOCP CHPID macro instruction replaces the system generation CHANNEL 
macro instruction. For an MVS/370 system generation, the CHANNEL and 
CHPID macro instructions are mutually exclusive. That is, you cannot specify 
them in the same input deck. MVS/370 system generation obtains the channel 
number and channel type from the CHPID macro instruction for its own 
processing. 


¢ MVS/370 system generation ignores the IOCP-related parameters CUNUMBR 
and TIMEOUT on the IODEVICE macro instruction. However, if the PATH 
parameter or UNITADD parameter is on any of the IODEVICE macro 
instructions, you cannot use a combined deck for an MVS/370 system 
generation. All other parameters remain unchanged for system generation 
processing. 


¢ MVS/370 system generation ignores the IOCP ID and CNTLUNIT macro 
instructions. 


¢ All other MVS/370 system generation macro instructions and parameters remain 
unchanged. 


Summary of MVS/XA System Generation 
The following is a summary of the MVS/XA (releases prior to MVS/SP 2.2.0) system 
generation macro instructions and the processing for a combined deck: (MVS SP 
2.2.0 provides the MVS Configuration Program (MVSCP) to perform the system 
generation functions.) 


e MVS/XA system generation ignores the IOCP-related parameters CUNUMBR, 
PATH, TIMEOUT and UNITADD on the IODEVICE macro instruction. All 
other parameters remain unchanged for MVS system generation processing. 


e MVS/XA system generation ignores the IOCP CHPID, CNTLUNIT, and ID 
macro instructions. 


e All other MVS/XA system generation macro instructions and parameters remain 
unchanged. — 


In the combined input deck, you can also define channels and devices for use only 
by processor complexes other than the processor complexes listed on the cover of 
this manual. These channel and device definitions are for MVS system generation 
only, and you instruct IOCP to exclude them from the IOCDS. For information on 
coding these channels and devices, see the descriptions of the PATH parameter on 
the CHPID macro instruction and the CUNUMBR parameter on the IODEVICE 
macro instruction in Chapter 2. 


Appendix B shows a listing of a typical combined input deck containing both IOCP 
and MVS system generation macro instructions. This deck is input both for an 
MVS/370 system generation and a 370/370-XA level of IOCP. MVS/XA may not 
support some of the devices defined in this deck. (See MVS/Extended Architecture 
System Generation Reference.) 


MVS system generation processes the IOCP macro instructions, in the same manner 
as the system generation macro instructions. IOCP itself does not use a macro 
generation process. IOCP processes its macro instructions in the same way as it 
processes control statements. 
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For a full description of the IOCP macro instructions and the IOCP-related 
parameters on the IODEVICE macro instruction, see “Specifying IOCP Macro 
Instructions” in Chapter 2. For a full description of MVS system generation macro 
instructions, see OS/VS2 System Programming Library: System Generation Reference 
or MVS/Extended Architecture System Generation Reference. 


Figure 1-6 shows an overview of the processing performed by the MVS version of 
IOCP. 
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1. The input deck contains both MVS system generation and IOCP macro 
instructions (or IOCP macro instructions only). . 

2. IOCP processes the IOCP macro instructions, generates an IOCDS in storage, 
produces reports, and, when requested, writes the generated IOCDS to 
one or more IOCDS(s) in the processor controller. 

3. The configuration reports allow you to check the I/0 configuration as 
defined in the IOCDS. 

4, The I0CDS(s) reside on the processor controller file. At power-on reset 
or SYSIML CLEAR, the processor controller microcode loads the I/0 
configuration data into hardware system area (HSA). (The channel subsystem 
subsequently uses the data to control 1/0 requests.) 

5. MVS system generation processes the system generation macro instructions 
and creates the MVS system. 


Figure 1-6. MVS Version (releases prior to MVS/SP 2.2.0) of IOCP - Overview 
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IOCP and MVS Configuration Program (MVSCP) 
The MVS configuration program replaces the I/O definition functions IOGEN and 
EDTGEN) previously available through SYSGEN. The MVS configuration 
program, in combination with other program enhancements, enables one copy of the 
MVS nucleus to support multiple I/O configurations. Also, with the MVS 
configuration program, modifications to the nucleus do not have to be reapplied 
after an installation updates an existing I/O configuration. 


In addition to defining each I/O configuration to MVS, you must also use the IOCP 
configuration program (IOCP) to define the configuration to the channel subsystem. 
You can use the same input stream to define the configuration to both the MVS 
configuration program and IOCP. 


Figure 1-7 on page 1-22 shows the relationship of IOCP and MVS Configuration 
Program. 


Although the figure shows the MVS configuration program and the IOCP running at 
the same time, you can actually run these programs at separate times independent of 
each other. They are shown together only to remind you that they share a common 
input stream. 
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Figure 1-7. IOCP and MVS Configuration Program 
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Overview of the VM Version of IOCP 
The VM version of IOCP runs under the control of either the VM/System Product 
(VM/SP), the VM/System Product High Performance Option (VM/SP HPO), or the 
VM/Extended Architecture Systems Facility (VM/XA Systems Facility). 


You invoke the VM version of IOCP in the CMS environment. The CMS IOCP 
command executes IOCP and has options that allow you to request the following 
IOCP functions: 


¢ Generating an IOCDS -- IOCP reads, validates, and checks the syntax of the 
input macro instructions. It generates an IOCDS in storage based on the 
configuration defined by the macro instructions and produces reports of the 
IOCDS generated in storage. When requested, IOCP writes the generated 
IOCDS to one or more IOCDS in the processor controller. 


¢ Producing Configuration Reports -- IOCP reads one or more IOCDS(s) from the 
processor controller into storage and prints the IOCP configuration reports. 
(See “Chapter 5. IOCP Configuration Reports” for examples.) 


The VM version of IOCP has an advantage over the stand-alone version: you may 
modify an IOCDS while other system operations continue. Then, at a convenient 
time, shut down your VM/SP, VM/SP HPO, or VM/XA Systems Facility system, 
power-on reset the processor complex (with the new IOCDS), and re-load VM/SP, 
VM/SP HPO, or the VM/XA Systems Facility. This method minimizes the amount 
of time that the system must be inactive while you reconfigure the I/O devices. 


For a full description of the VM version of IOCP, see “Chapter 3. Executing the 
VM Version of IOCP.” 


IOCP and System Generation of a VM Operating System 


You must define your I/O configuration to both software and hardware. 


To define your I/O configuration to software, you use a set of I/O macro 
instructions in the real I/O configuration file for your VM operating system: 


¢ For VM/SP or VM/SP HPO, the real I/O configuration file is the DMKRIO 
file. 


¢ For the VM/XA Systems Facility, the real I/O configuration file is the HCPRIO 
file. 


When you perform system generation, the Control Program (CP) uses the macro 
instructions in the real I/O configuration file to define the I/O configuration to the 
operating system. 


To define your I/O configuration to hardware, you use another set of I/O macro 
instructions in a separate IOCP file. When you enter the IOCP command, the IOCP 
program uses the I/O macro instructions in the IOCP file to define the I/O 
configuration to the processor complex. 


For more information about performing these tasks, see “Methods of Executing the 
VM Version of IOCP” in Chapter 3. 


Figure 1-8 shows an overview of the processing performed by the VM version of 
IOCP. 
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1. For VM/SP and VM/SP HPO system generation, the DMKRIO file defines the 
I/0 configuration information; for VM/XA Systems Facility system generation, 
the HCPRIO file defines the 1/0 configuration. 

2. The input file contains the IOCP macro instructions used to define the 
1/0 configuration to the processor controller. 

3. IOCP processes the IOCP macro instructions, generates an IOCDS in 

storage, produces reports, and, when requested, writes the generated 

IOCDS to one or more IOCDS(s) in the processor controller. 

The configuration reports allow you to check the 1/0 configuration as 

defined in the IOCDS. 

5. The I0CDS(s} reside in. the processor controller file. At power- on reset 
or SYSIML CLEAR, the processor controller microcode loads the 1/0 
configuration data into the hardware system area (HSA). (The channel 
subsystem subsequently uses the data to control 1/0 requests. ) 


> 


Figure 1-8. VM Version of IOCP - Overview 
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Overview of the Stand-Alone Version of IOCP | 
The stand-alone version of IOCP is a stand-alone program operated from the system 
console or the service support console on the processor complex. 


You execute the stand-alone version of IOCP to define I/O configuration data when 
you are operating your system before installing MVS, VM/SP, VM/SP HPO, or the 
VM/XA Systems Facility, or when you are operating your system with a control 
program other than these. 


You start IOCP from the system console or the service support console. Briefly, the 
functions you can request are: 


¢ Read an IOCDS from the processor controller into the IOCDS area of main 
storage. 


¢ Display, add, alter, and delete 1/O configuration data from the IOCDS in 
storage. 


° Print reports of the IOCDS that is in storage. 


¢ Build an IOCDS in storage (which also produces reports) based on the 
card-image macro instructions read from a.card reader or magnetic tape. 


¢ Write the IOCDS (generated or modified) in storage to an IOCDS in the 
processor controller. 


Also, when you are executing the stand-alone version of IOCP, you can dump the 
IOCP storage area, which includes the IOCDS in storage. 


For a full description of the stand-alone version of IOCP, see “Chapter 4. Executing 
the Stand-Alone Version of IOCP”. 


Figure 1-9 shows an overview of the processing poten by the stand-alone 
version of IOCP. 
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or SYSIML CLEAR, the processor controller microcode loads the I/0 
configuration data into the hardware system area (HSA). (The channel 
subsystem subsequently uses the data to control I/0 requests.) 
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Chapter 2. Executing the MVS Version of lIOCP 


The MVS version of the input/output configuration program (IOCP) runs as a job 
under control of MVS (MVS/370 or MVS/XA) The IOCP program name is 
ICPIOCP. 


You use JCL statements to execute IOCP. On the EXEC statement, you code 
options on the PARM parameter to request one of the following two IOCP 
functions: 


¢ Generating an Input/Output Configuration Data Set (IOCDS) - IOCP reads, 
validates, and checks the syntax of input macro instructions. It generates an 
IOCDS in storage based on the configuration defined on the macro instructions 
and produces reports of the IOCDS generated in storage. When requested, IOCP 
writes the generated IOCDS to one or more IOCDS(s) in the processor 
controller. 


¢ Producing Configuration Reports - [OCP reads one or more IOCDS(s) from the 
processor controller into storage and prints the IOCP configuration reports. 
(See “Chapter 5. IOCP Configuration Reports” for examples.) 

The following topics describe: 

¢ How to specify IOCP macro instructions bi 

¢ The two functions IOCP performs 

¢ The JCL statements required to execute these functions (with examples) 

¢ The return codes IOCP can set 


¢ How to initially define the I/O configuration or to redefine an existing I/O 
configuration. 
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Specifying IOCP Macro Instructions 
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This section describes the purpose of the IOCP macro instructions and explains how 
to code them. The first topic in this chapter summarizes the I/O configuration rules 
that apply to the IOCP macro instructions. Subsequent topics describe the IOCP 
macro instructions in alphabetic order. 


The rules for coding the IOCP card-image macro instructions are the same as the 
rules for coding MVS system generation or MVSCP macro instructions. They are 
the rules of assembler language. See “Appendix A. Coding IOCP Macro 
Instructions” for a summary of the rules for coding the macro instructions and the 
notation used in this book to illustrate the macro instructions. 


IOCP has four macro instructions: CHPID, CNTLUNIT, IODEVICE, and ID. 
IOCP requires the CHPID, CNTLUNIT, and IODEVICE macro instructions. The 
CHPID, CNTLUNIT, and IODEVICE macro instructions define respectively, the 
channel paths, control units, and I/O devices in your configuration. The ID macro 
instruction is optional. If you want specific identification information in the heading 
of the IOCP configuration reports, code the ID macro instruction. 


The following general rules apply to the sequence of the IOCP macro instructions in 
the input deck. 


¢ You can code the ID macro instruction only once and it must precede other 
IOCP macro instructions. 


¢ A CHPID macro instruction that defines the channel path must precede a 
CNTLUNIT macro instruction that refers to the channel path. 


¢ ACNTLUNIT macro instruction must follow the CHPID macro instruction 
that defines the channel path to which the control unit attaches. 


¢ An IODEVICE macro instruction must follow the CNTLUNIT macro 
instruction that defines the control unit to which the device is assigned. 


¢ You can insert IOCP comment cards (specified by the characters *IOCP in 
columns 1 through 5) in the input deck where desired. 


We suggest that you group all CHPID macro instructions together, followed by all 
CNTLUNIT macro instructions, and then all IODEVICE macro instructions. Or, 
you might group all CHPID macro instructions together, followed by groups of 
related CNTLUNIT and IODEVICE macro instructions (as shown in Appendix B). 


Figure 2-1 shows a typical combined input deck containing IOCP macro instructions 
and, MVS system generation macro instructions. Appendix B shows a listing of a 
typical combined input deck containing both IOCP and system generation macro 
instructions. 
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1OCP Macro Instructions 


1. ID macro instruction (optional) defines heading data for 
configuration reports; IOCP allows only one ID macro instruction. 

2. CHPID macro instruction (required) defines channel paths. You can 
define up to 8 channel paths on each CHPID macro instruction. 

3. CNTLUNIT macro instruction (required) defines control units. You must 
define each control unit on a separate CNTLUNIT macro instruction. 

4, IODEVICE macro instruction (required) defines 1/0 devices. You can 
define up to 256 1/0 devices on an IODEVICE macro instruction. 

The IODEVICE macro instruction contains information required by both 
MVS system generation and IOCP. 

5. MVS system generation macro instructions (required and optional MVS 
system generation macro instructions - excluding CHANNEL macro 
instructions) define the software configuration. (The CHPID macro 
instructions replace the CHANNEL macro instructions in an MVS/370 
system generation. An MVS/XA system generation does not use the 
CHANNEL macro instruction.) 


Figure 2-1. Typical Combined Input Deck (IOCP and MVS System Generation) 
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Summary of I/O Configuration Rules 


Here is a summary of the rules and restrictions for IOCP macro instructions 
described in the following topics. 


For channel paths 


For control units 


2-4 


You can specify all channel paths as block multiplexer 


You can specify, for the A side, only channel paths 00, 01, 02, 03, 10, 11, 12, 
and 13 (hex) as byte multiplexer. 


You can specify, for the B side, only channel paths 40, 41, 42, 43, 50, 51, 52, 


~ and 53 (hex) as byte multiplexer. 


You can specify a maximum of four channel paths on each side as byte 
multiplexer. 


You can attach a physical control unit to a maximum of four channel paths per 
system. 


You can assign a maximum of 16 control units to one channel path. 


Only a non-shared control unit (specified by SHARED =N on the CNTLUNIT 
macro instruction) can attach to a channel path that operates in byte multiplexer 
mode. 


Only a control unit attached to a block multiplexer channel path can use the 
data streaming interface protocol. That is, if PROTOCL=S or S4 on the 

CNTLUNIT macro instruction, the channel path(s) to which the control unit 
attaches must have TYPE=BL specified on the CHPID macro instruction(s). 


When you are running IOCP to verify the card-image input deck, 

(WRTCDS= NO), IOCP allows a maximum of two channel paths per data 
server element (DSE) to attach to physical control units that have 
PROTOCL=S4. Likewise, when generating an IOCDS on a Model X 
processor, IOCP allows a maximum of two channel paths per DSE to attach to 
physical control units that have PROTOCL=S4. However, when generating an 
IOCDS on a processor that is not a Model X, IOCP restricts the channel paths 
that can attach to the physical control unit that has PROTOCL=S4. This 
control unit can attach only to channel paths with the following identifiers: 06, 
07, 16, 17, 26, 27, 46, 47, 56, 57, 66, and 67. For a pictorial description of data 
server elements, see Figures 1-1 and 1-2 in Chapter 1. 
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For I/O devices 


For 370-XA mode 


The maximum number of I/O devices is 4080. 


The sum of the number of I/O devices plus the number of logical control units 
cannot exceed 4096. 


You can assign a maximum of 256 I/O devices to one channel path. 
You can assign a device to a maximum of four control units. 


When you assign a device to more than one control unit, each control unit must: 
(1) recognize the same unit address for the device, (2) not attach to the same 
channel path, (3) have the same PROTOCL value, and (4) have the same 
characteristics, such as shared, shared block, or nonshared. 


You can assign a device only to a combined maximum of four channel paths 
(even though you can assign a device to up to four control units and attach a 
control unit to up to four channel paths). 


You cannot assign a device that has the I/O interface timeout function inhibited 
to a channel path that operates in byte multiplexer mode. 


Each I/O device must have a unique device address/number within the I/O 
configuration. IOCP does not allow duplicate device addresses/numbers. 


If you have a deck of IOCP macro instructions coded for the 370 level of IOCP, 
in most cases you can use the same deck as input to create a 370/370-XA 
IOCDS. MVS/XA may not support all of the defined devices. 


Note: I/O configurations that are valid for the 370 level of IOCP or for 370 
only machines may be invalid for the 370-XA level of IOCP. It is important to 
fully understand the concepts and requirements of logical control units. It may 
be necessary to physically reconfigure a system if the requirements for logical 
control units have not been met. You must review the current configuration to 
insure that the configuration is valid for the 370-XA level of IOCP. This is 
necessary whether you are running your processor in 370 mode or in 370-XA 
mode. 


You can define a channel path and its attached I/O devices exclusively for 
370-XA mode by removing the channel number and channel set for that channel 
path from the CHPID macro instruction. 


The PATH parameter on the IODEVICE macro instruction specifies a preferred 
path. The preferred path is an optional parameter used only for 370-XA mode 
operation. 
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CHPID 


CHPID, a required macro instruction, describes: 


¢ The characteristics of channel paths 


e The correspondence of channel paths to channel numbers and channel sets 


You must specify each channel path in your I/O contipamdon on a CHPID macro 
instruction in order to use the channel path. You can specify up to eight channel 
paths on one CHPID macro instruction. When using an input deck containing MVS 
system generation and IOCP macro instructions, you can define, to MVS system 
generation, channels used only by processors other than the processor complexes 
listed on the cover of this manual. (See the note in the description of chpid number 
on the PATH parameter.) 


Note: For an MVS/370 system generation, the CHPID macro instruction is 
mutually exclusive with the system generation CHANNEL macro instruction. You 
cannot specify the CHPID and CHANNEL macro instructions in the same input 
deck to the MVS system generation process. On the CHPID macro instruction, the 
channel number on the PATH parameter replaces the ADDRESS parameter of the 
CHANNEL macro instruction, and the TYPE=BL and TYPE=BY parameters 
replace the TYPE = BLKMPXR and TYPE=MULTIPLEXOR parameters 
respectively. The CHPID macro instruction does not support the 

TYPE =SELECTOR and TYPE = HISPEEDMPXR parameters on the CHANNEL 
macro instruction. 


The CHPID macro instruction must follow the ID macro instruction, if you specified 
the ID macro instruction). The CHPID macro instruction must precede any 


CNTLUNIT macro instructions that refer to the channel path. 


The format of the CHPID macro instruction is: 


[symbol] | CHPID PATH =((chpid number[,channel number 


[,channel set ]]),...) 
TYPE = {BL|BY} 


PATH= 
specifies one or more channel path identifiers. If the devices on a channel path 
are for use in 370 mode, you must specify the channel path’s corresponding 
channel number. Optionally, you may specify the channel path’s associated 
channel set. You can specify a maximum of eight channel paths on one CHPID 
macro instruction. If you specify more than one channel path on a macro 
instruction, all channel paths must have the same TYPE characteristic. You 
cannot specify a channel set without specifying a channel number. 


chpid number 
specifies the channel path identifier. For the A side, you must specify two 
hexadecimal digits in the range of 00 through 07, 10 through 17, or 20 
through 27. (Channel paths 10 through 17 and 20 through 27 are optional 
by model.) For the B side, you must specify two hexadecimal digits in the 
range of 40 through 47, 50 through 57, or 60 through 67. 
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Note: Specify ** (two asterisks) instead of a chpid number when defining, 
to MVS system generation a channel used only by processors other than the 
processor complexes listed on the cover of this manual. You can code ** 
only if you use card-image input and specify IGNORE= YES. IOCP 
ignores the channel number and channel set following **: it does not include 
them in the IOCDS. 


For example, the 3081 Processor Complex can have up to 24 channel paths 
while the 3033 Processor Complex can have up to 32 channel paths. Ina 
combined input deck used by both IOCP and MVS system generation, you 
specify ** to have IOCP ignore (not include in the IOCDS) the additional 
channels of the 3033 Processor Complex. 


For devices you assign to channels used only by processors other than the 
processor complexes listed on the cover of this manual, you must code the 
IODEVICE macro instruction so that IOCP does not include the devices in 
the IOCDS. See the description of the CUNUMBR parameter on the 
IODEVICE macro instruction. 


channel number 
specifies the channel number that corresponds to the channel path when the 
processor complex operates in 370 mode. You specify one hexadecimal digit 
in the range of 0 through F. Channel numbers must be unique and 
consecutive within a channel set. 


To specify a channel set, you must specify a channel number. If you do not 
specify the channel number, you cannot access the devices attached to the 
channel path when the processor complex operates in 370 mode. 


channel set 
specifies the channel set used for 370 mode. You specify a value of 0 or | 
for the channel set. If you do not specify a channel set, IOCP assigns the 
channel path to channel set 0. : 


On a processor complex with both an A side and a B side, each side has two. 
channel sets (0 and 1) in 370 mode. 


On the uniprocessors, MVS/370 can access only channel paths assigned to 
channel set 0. Therefore, you must either specify a value of 0 or accept the 
default of 0. (You can assign channel paths to channel set 1; however, 
MVS/370 cannot access these channel paths on a (aipnacessor) 


A channel set cannot have more than 16 channel paths assigned to it. The 
two channel sets (0 and |) can have a maximum combined total of 24 
channel paths on each side. (For example, 16 channel paths assigned to 
channel set 0 and 8 channel paths assigned to channel set 1, or 12 channel 
paths assigned to channel set 0 and 12 channel paths assigned to channel set 


1.) 


For the processor complex, you must assign consecutive channel numbers 
within a channel set. (For example, channel numbers 0, 1, 2, 3, 4, 5, or 
channel numbers 8, 9, A, B, C, D. ) The channel path identifiers do not need 
to be consecutive. 


For a uniprocessor, processor 2 (the only processor) always connects to 
channel set 0 at power-on reset, SYSIML or SYSIML CLEAR. Fora 
processor complex with more than one processor, channel set connection at 
power-on reset, SYSIML or SYSIML CLEAR depends on whether the 
processor complex has one or both processors configured. 
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When the processor complex has both processors configured, channel set 0 
connects to processor 0, and channel set | connects to processor 2 at 
power-on reset, SYSIML or SYSIML CLEAR. (if the processor complex 
has a B side, channel set 0 on the B side connects to processor 1, and 
channel set 1 on the B side connects to processor 3.) When the processor 
complex subsequently resets (such as a system reset or load), channel set 0 
reconnects to processor 0 (or processor | on the B side) and channel set 1 
reconnects to processor 2 (or processor 3 on the B side). 


If you remove either processor from the processor complex (the processor 
fails or you take it offline), channel set 0 and channel set 1 both remain 
configured. However when you remove a processor, a subsequent reset 
causes the connection of channel set 0 to the remaining processor on that 
side. The reset does not connect channel set 1, but you can connect channel 
set | after IPL by activating channel set switching. Therefore, we 
recommend that you assign critical asymmetrically attached devices (such as 
the operator’s console) to a channel path assigned to channel set 0. 


TYPE= 
specifies the mode of I/O operation for the channel path. If you specify more 
than one channel path on a macro instruction, all channel paths must have the 
same TYPE characteristic. 


BL 
specifies that the channel path is a block multiplexer channel, which operates 
in burst mode only and allows multiplexing between blocks. You can 
specify TYPE=BL for all channel paths with the exception that MVS 
system generation requires that the channel path assigned as 370 channel 
number 0 be a byte multiplexer channel. 


BY 
specifies that the channel path is a byte multiplexer channel, which operates 
in burst mode or byte-interleave mode, depending on the attached control 
unit. You can specify TYPE=BY for only channel paths 00 through 03 and 
10 through 13 (hex) on the A side, and for channel paths 40 through 43 and 
50 through 53 (hex) on the B side. You can specify a maximum of four 
channel paths on each side as TYPE=BY. 


Note: All channel paths defined with the same channel number must specify the 
same type value. 


Example: The following macro instruction (named CHSET1) defines two channel 
paths (hex 15 and 16) with their corresponding channel numbers (hex 8 and 9) in 
channel set 1. It also defines a channel (using ** instead of a chpid number) with 
channel number hex A in channel set 1. By using **, you define the channel to 
MVS system generation for use by processors other than the processor complexes 
listed on the cover of this manual. [OCP excludes from the IOCDS the channel 
number and channel set following **. The channel paths are to operate in block 
multiplexer mode. 


CHSET1 | CHPID | PATH=((15,8,1),(16,9,1),(**,A,1)), TYPE = BL 
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Example: The following macro instruction (named CHP17) defines channel path 17. 
The channel path operates in block multiplexer mode. Because no channel number 
is specified, the processor complex can access the devices attached to this channel 
path only when it operates in 370-XA mode. 


CHP17 CHPID PATH = 17,TYPE=BL 
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CNTLUNIT 


CNTLUNIT, a required macro instruction, describes: 


e The characteristics of the control unit 
¢ The channel paths to which the control unit attaches 
¢ The unit addresses that the control unit recognizes 


You must specify each physical control unit in your I/O configuration in a separate 
CNTLUNIT macro instruction to use the physical control unit. This requirement 
includes control units that reside either in the same physical unit as an I/O device or 
another control unit. 


You can attach a control unit to a maximum of four channel paths. You can assign 
a maximum of 16 control units to one channel path. 


See Appendix D for a list of control unit types and their characteristics. 


Based on information in the CNTLUNIT macro instruction(s), IOCP constructs 
logical control units for the channel subsystem to use when the processor runs in 
370-XA mode. A logical control unit is a logical representation of one to four 
physical control units. IOCP builds a logical control unit for: 


e Each control unit with no devices or no devices shared with other control units. 
¢ Each group of two to four control units that share devices between them. 


The channel subsystem uses the logical control units for queuing I/O requests for the 
devices attached to the associated physical control units. There is one I/O request 
queue for each logical control unit. The channel subsystem queues all I/O requests 
for all devices in the logical control unit (all the devices attached to the set of 
physical control units in the logical control unit) to the same I/O request queue. 


IOCP also establishes a rotation order for the channel paths associated with each 
logical control unit. When initiating I/O requests queued to the logical control unit, 
the channel subsystem uses this rotation order to determine the sequence for 
selecting channel paths. The section “Rotation Algorithm” in Chapter | describes 
how IOCP establishes the rotation order of the channel paths. 


The CNTLUNIT macro instruction must follow any CHPID macro instructions that 
specify channel paths used by the control unit. The CNTLUNIT macro instruction 


must precede any IODEVICE macro instructions that refer to the control unit. 


The format of the CNTLUNIT macro instruction is: 


[symbol] CNTLUNIT CUNUMBR = number 
PATH = (chpid[,chpid]...) 


[PROTOCL = {D|S|S4}] 

SHARED = {Y|YB|N} 

UNIT = type 

UNITADD = ((address[,number ]),...) 


CUNUMBR = number 
specifies the hexadecimal number assigned to the control unit. You specify three 
hexadecimal digits in the range of 000 through FFF. You must assign a unique 
number to each control unit. However, you can arbitrarily assign the numbers. 
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PATH = chpid 
specifies the channel path(s) attached to the control unit. You specify one to 
four channel path identifiers for the control unit. You must specify two 
hexadecimal digits for each channel path identifier. 


Note: If you specify the control unit as shared (SHARED =Y) or shared block 
(SHARED = YB), then you cannot specify channel paths that operate in byte 
multiplexer mode for the control unit. 


PROTOCL= 
specifies the interface protocol that the control unit uses when operating with the 
channel paths specified on the PATH parameter. 


D 
specifies the D. C. interlock protocol. This protocol is the standard I/O 
interface that requires the demand response. D is the default if you do not 
code PROTOCL. | 

S 


specifies the data streaming protocol at a data rate of up to 3.0 megabytes. 
This protocol does not require the demand response but continues at the 
rate governed by the control unit. S is valid only for a control unit that is 
attached to block-multiplexer channel paths. 


S4 
specifies the data streaming protocol at a data rate of up to 4.5 megabytes. 
This protocol does not require the demand response but continues at the 
rate governed by the control unit. S4 is valid only for a control unit that is 
attached to block-multiplexer channel paths. 


Note: You may specify S4 if your processor has been upgraded to support 
a data rate of 4.5 megabytes. To operate at 4.5 megabytes on a Model X 
processor, no more than two channel paths per DSE can attach to control 
units that have PROTOCL=S4. To operate at 4.5 megabytes on a 
processor that is not a Model X, the control unit can only be attached to 
channel paths with the following identifiers: 06, 07, 16, 17, 26, 27, 46, 47, 
56, 57, 66, and 67. 


Note: Incorrect specification of the PROTOCL parameter may produce 
unpredictable results. For example, if you specify S (data streaming) for a 
control unit that supports the D. C. interlock protocol, I/O requests can result in 
either detected errors (such as data overruns or interface control checks) or in 
undetected errors. 


SHARED = 
specifies the level of concurrency of I/O requests that the channel allows for the 
control unit. In 370 mode, the parameter specifies the assignments of 
subchannels. In 370-XA mode, IOCP sets the control unit type (1 or 2) 
automatically based on the SHARED parameter that you specify. See Appendix 
D for more information on specifying the SHARED parameter. (For further 
information on control unit types, see the topic “Logical Control Units” in 
Chapter 1.) 
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specifies that the control unit (such as the 3803 for magnetic tape units) has 
one or both of the following attributes: 


e The control unit supports only one I/O request at a time, regardless of 
the number of I/O devices attached. 


¢ The control unit clears pending sense information in the control unit for 
an I/O device if the channel initiates an I/O request for another attached 
1/O device. 


For 370 mode, assigned to all the devices attached to a control unit is a 
single shared subchannel (for each attaching channel path) and the channel 
operates in selector mode. For 370-XA mode, you assign the control unit as 
type | and each device as a subchannel. 


In both modes, the channel ensures processing of only one I/O request at a 
time for all devices sharing the control unit. For 370-XA mode if sense 
information is pending in the control unit for an I/O device attached to the 
control unit, the channel ensures that I/O requests for other I/O devices 
attached to the control unit are not initiated until the system control 
program issues an I/O request to clear the pending sense information. 


You cannot specify SHARED =Y for control units that attach to a byte 
multiplexer channel path. 


specifies that the control unit (such as the 3258, 3272, or 3274) has one or 
both of the attributes of SHARED=Y, but supports disconnect command 
chaining (DCC) operations. 


For 370 mode, assigned to all the devices attached to a control unit is a 
single shared subchannel (for each attaching channel path)and the channel 
operates in block multiplexer mode. 


For 370-XA mode, you assign the control unit as type 1 and each device as 
a subchannel. 


In both modes, the channel ensures processing of only one I/O request at a 
time for all devices sharing the control unit. For 370-XA mode, if sense 
information is pending in the control unit for an I/O device attached to the 
control unit, the channel ensures that I/O requests for other I/O devices 
attached to the control unit are not initiated until the system control 
program issues an I/O request to clear the pending sense information. 


You cannot specify SHARED = YB for control units that attach to a byte 
multiplexer channel path. 


specifies that the control unit supports multiple I/O requests concurrently 
(one for each attached I/O device). 


Each I/O device attached to the control unit is assigned a separate 
subchannel. For 370-XA mode, the control unit is assigned as type 2. 


The channel accepts and initiates one I/O request for each I/O device and 
operates in either block or byte multiplexer mode, depending on how you 
specified the attaching channel path. 
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UNIT = type 
specifies the type of control unit. You specify up to five alphanumeric 
characters that identify the type of control unit. IOCP checks only the syntax 
for alphanumeric characters. IOCP does not validate the type value. 


You must specify a type for every control unit in your I/O configuration. You 
specify a type on the UNIT parameter in one of two ways: 


¢ For devices that do not have a separately assigned control unit type (for 
example, when the control unit function is built into the same physical unit 
as the device), you can specify the device type on the UNIT parameter. For 
example, for the 3800 Printing Subsystem you can specify UNIT = 3800 on 
the UNIT parameter of the CNTLUNIT macro instruction (as well as 
UNIT = 3800 on the IODEVICE macro instruction). 


e For devices that do have a separately assigned control unit type, you must 
specify the specific control unit type on the UNIT parameter (such as 
UNIT = 3803). 


UNITADD = 


address 
specifies the unit addresses of the I/O devices that the control unit 
recognizes. You specify two hexadecimal digits in the range of 00 through 
FF. You must specify at least one unit address. A unit address need not 
represent an attached device. (For example, UNITADD = ((0A),(0B),(0F)) 
specifies that the control unit recognizes unit addresses 0A,OB, and OF.) 


number 
specifies the number of sequential unit addresses recognized by the control 
unit. You specify a one-, two-, or three-digit decimal value in the range of | 
through 256. (For example, UNITADD = ((0A,3)) specifies that the control 
unit recognizes unit addresses 0A, OB, and OC.) The unit address plus the 
number of addresses must not exceed a hexadecimal address of FF. If you 
omit a number, a value of 1 is assumed. 


You can specify a maximum of eight addresses and/or sets of address and 
number values. If you do not specify the UNITADD parameter on the 
JODEVICE macro instruction, the unit addresses specified must include the 
device addresses (the second and third digits) specified on the ADDRESS 

' parameter of the IODEVICE macro instruction for the attached devices. If you 
specify the UNITADD parameter on the IODEVICE macro instruction, the unit 
addresses specified must include the unit addresses specified on the UNITADD 
parameter for the attached devices. 


Note: See Appendix D for the exceptions and recommendations that apply to 
specific device types. 


You must specify the full range of unit addresses that the control unit can 
address whether devices are attached or not. 
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CUO00E | CNTLUNIT 


Example: The following macro instruction assigns the control unit number of 10A 
to an IBM 2821 Control Unit, names channel path 06 to which the control unit 
attaches, and defines unit addresses 0A, 0B, and OC that the control unit recognizes. 
D is the default for PROTOCL. | 


CUL0A | CNTLUNIT CUNUMBR = 10A,PATH = 06,SHARED=N, 
| | UNIT = 2821, UNITADD = ((0A,3)) 


Example: The following macro instruction assigns the control unit number of 00E 
to a 3803 Tape Control, names channel path 05 to which the control unit attaches, 

specifies the D. C. interlock protocol, and defines unit addresses 80 through 8F that 
the control unit recognizes. 


CUNUMBR=00E,PATH =05,PROTOCL = D, 
SHARED = Y, UNIT = 3803, UNITADD = ((80,16)) 


Example: The following macro instruction assigns the control unit number 11A to a 
control unit that the customer has named DUMMY, names two channel paths 06 
and 07 to which the control unit is attached, and defines unit addresses 90 through 
9F and AO through AF that the control unit recognizes. 


CULLA | CNTLUNIT CUNUMBR = 11A,PATH = (06,07), PROTOCL =D, 
SHARED = Y,UNIT=DUMMY, 
UNITADD = ((90,16),(A0, 16)) 


Example: The following macro instruction assigns the control unit number of 031 
to an IBM 3272 Control Unit, names channel path 04 to which the control unit is | 
attached, and defines unit addresses DO through DF that the control unit recognizes. 


CNTLUNIT CUNUMBR = 031,PATH = 04,PROTOCL=D, 


SHARED = YB, UNIT = 3272, 
UNITADD = ((D0,16)) 
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ID is an optional macro instruction that describes the identification information 
printed on the ID1 and ID2 lines of the IOCP configuration report headings. It is 
also the source of the customer name (data set name) for the IOCDS that appears 
on the IOCDSM (SYS021) frame. 


See “Chapter 5. IOCP Configuration Reports” for examples of the headings used on 
the reports. 


When specified, the ID macro instruction must precede all CHPID, CNTLUNIT, 
and IODEVICE macro instructions in the input stream. You can specify the ID 
macro instruction only once in the input deck. If you do not specify the ID macro 
instruction, the ID1 and ID2 lines of the heading do not have identifying 
information. . 


The format of the ID macro instruction is: 


[symbol] MSGI1 = ‘message’, MSG2 = ‘message’ 


MSGI = ‘message’ 
MSG2= ‘message’ 


MSG1 = 
specifies the identification information printed on the ID1 line of the heading on 
IOCP configuration reports. The processor controller also uses the first eight 
characters of MSG1 = (bytes | through 8) as the customer name for the IOCDS 
that appears on the IOCDSM (SYS021) frame. (For more information, see the 
operator’s guide for your system console.) 


MSG2 = 
specifies the identification information printed on the ID2 line of the heading on 
IOCP configuration reports. 


‘message’ 
specifies a string of 1 through 64 alphanumeric characters used as identification 
information. You must enclose the string within apostrophes. Two consecutive 
apostrophes count as one character and indicate an apostrophe within the string 
(such as, MSG1 = ‘John’s I/O Report’). 


Example: The following macro instruction defines the identification information 
printed on lines ID1 and ID2 on the heading of the IOCP configuration reports. 

TPCONFIG is the customer name for the IOCDS that appears on the IOCDSM 
(SYS021) frame. * 
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IODEVICE 


IODEVICE, a required macro instruction, describes: 


¢ The I/O device address/number 
e The device characteristics 
¢ The control units to which the device is assigned 


An IODEVICE macro instruction used for I/O requests must specify each uniquely 
addressable I/O device in your I/O configuration. When using an input deck 
containing MVS system generation macro instructions and IOCP macro instructions, 
you can define, to MVS system generation, devices used only by processors other 
than the processor complexes listed on the cover of this manual. (See the note in the 
description of the CUNUMBR parameter on this macro instruction.) 


Note: MVS/System Product Version 1 or Version 2 does not necessarily support 
devices supported by IOCP. For a list of the devices supported by MVS/System 
Product Version 1, see OS/VS2 MVS/System Product General Information Manual; 
for MVS/System Product Version 2, see MVS/System Product Version 2 General 
Information Manual. 


You can assign up to 256 devices to one channel path. You can assign one device to 
a maximum of four control units. Although you can attach a control unit to a 
maximum of four channel paths, you can only assign a device to a combined 
maximum of four channel paths. 


Each I/O device must have a unique device address/number within the I/O 
configuration. IOCP does not allow duplicate addresses. 


To assign an I/O device to both channel set 0 and channel set | (for 370 mode 
channel sets), specify the device address/number on an IODEVICE macro instruction 
and the device’s unit address on the CNTLUNIT macro instruction(s) that define(s) 
the control unit(s) attached to channel paths in both channel sets. (On a 
uniprocessor, MVS/370 can access only channel set 0; therefore, you must assign all 
I/O devices you want to use to channel set 0.) 


The IODEVICE macro instruction must follow any CNTLUNIT macro instructions 
that specify control units used by the device. 


The format of the IODEVICE macro instruction is: 


[symbol] | IODEVICE ADDRESS = (address[, number ]) 
CUNUMBR = (number[,number]...) 
[MODEL = model] 


[PATH =chpid] 
[TIMEOUT = {YiN}] 
UNIT = device 
[UNITADD = address ] 


If you are coding the IODEVICE macro instruction for use with an MVS system 
generation, use the description of the IODEVICE macro instruction found in 


~OS/VS2 System Programming Library: System Generation Reference or 


MVS/Extended Architecture System Generation Reference. 
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If you are coding the IODEVICE macro instruction for use with the MVS 
Configuration Program (MVSCP) use the description of the IODEVICE macro 
instruction found in MVS/Extended Architecture: MVS Configuration Program 
Guide and Reference The parameters that IOCP uses are a subset of the IODEVICE 
parameters used by system generation (except the COUNUMBR, PATH, TIMEOUT, 
and UNITADD parameters, which only IOCP uses). When you use card-image 
input and specify IGNORE= YES on the PARM parameter of the JCL EXEC 
statement, IOCP checks the syntax and validity of the OPTCHAN parameter, if 
present, on the I[ODEVICE macro instruction. Note that IOCP allows only one 
hexadecimal digit as the keyword value for OPTCHAN. 


ADDRESS = 


address 
specifies the device address in 370 mode and the device number in 370-XA 
mode. You specify three hexadecimal digits in the range of 000 through 
FFF. 


For 370 mode operation, the first hexadecimal digit (0-F) must specify the 
channel number that corresponds to the lowest-numbered channel path to 
which the device is assigned. This channel path is the primary channel 
address for the device. 


In 370-XA mode, the first hexadecimal digit does not have to correspond to 
the 370 channel number. If you want to use the same IOCDS to operate in 
both 370 mode and 370-XA mode, specify the first hexadecimal digit for 
370-XA mode the same way you do for 370 mode. 


MVS requires that the first digit must be the same for each device on a 
single control unit or for each DASD on a single string. In all cases, specify 
a hexadecimal digit in the range of 0 through F. 


If you do not specify the UNITADD parameter on the IODEVICE macro 
instruction, the second and third hexadecimal digits of the ADDRESS 
parameter specify the physical unit address that is transmitted on the 
channel path to select the device. You specify two hexadecimal digits in the 
range of 00 through FF. These two hexadecimal digits must match one of 
the unit addresses specified on the UNITADD parameter of the 
CNTLUNIT macro instruction that defines the control units assigned to the 
device. 


If you do specify the UNITADD parameter on the IODEVICE macro 
instruction, then the second and third digits of the ADDRESS parameter 
can have any value that follows the rules in Appendix D and makes the 
device address/number unique. The two digits specified on the UNITADD 
parameter must be the physical unit address. See Appendix D for the 
exceptions and recommendations that apply to specific device types. 


number 
specifies the number of sequential device addresses/numbers to be assigned. 
You specify a one, two, or three-digit decimal value in the range of 1 
through 256. (For example, ADDRESS =(10A,3) specifies that the device 
addresses of 1OA, 10B, and 10C are assigned.) 


If you do not use the UNITADD parameter on the IODEVICE macro 
instruction, the physical unit address (second and third digits) specified on 
the ADDRESS parameter plus the number of addresses minus one must not 
exceed a hexadecimal value of FF. 
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If you do use the UNITADD parameter, the device address/number 
specified on the ADDRESS parameter plus the number of addresses minus 
one must not exceed a hexadecimal value of FFF. 


If you omit number (when using card-image input) and you specify 
IGNORE=NO on the PARM parameter of the JCL EXEC statement, 
IOCP assumes a default value of 1. If IGNORE= YES, IOCP assumes a 
default value of 1 except for some devices, as noted in Appendix D. 


For example, if you use card-image input and specify IGNORE= YES, 
IOCP checks the syntax of the number subparameter for the 2305 Fixed — 
Head Storage and the 3838 Array Processor, but IOCP unconditionally 
assigns eight addresses to these devices. 


Each device address specified must be unique within the I/O configuration. 
IOCP does not allow duplicate addresses. 


CUNUMBR = number 
specifies the control unit numbers assigned to the control units (specified on the 
CUNUMBBR parameter of the CNTLUNIT macro instruction) to which the 
device attaches. You specify three hexadecimal digits in the range of 000 
through FFF for each control unit. 


You can assign a device to a maximum of four control units. Although you can 
attach each control unit to a maximum of four channel paths, you can only 
assign a device to a combined maximum of four channel paths. 


When you attach the device to more than one control unit (for example, via a 
string switch), you must specify each control unit. 


If you attach a device to more than one control unit, all control units that attach 
to the device must: 


¢ Use the same address to access the device assigned to the device on the | 
ADDRESS parameter of the IODEVICE macro instruction. 


¢ Have the same SHARED characteristic (Y, YB, or N). 
e Have the same interface protocol (D, S, or S4). 
¢ Not be attached to the same channel path. 


Note: Specify *** (three asterisks) instead of a number when defining, to MVS 
system generation, a device or devices used only by processors other than the 
processor complexes listed on the cover of this manual. (You must code *** if 
you coded ** for the chpid number on the CHPID macro instruction that 
defines the channel to which you are assigning the devices.) You can code *** 
only if you use card-image input and specify IGNORE= YES on the PARM 
parameter of the JCL EXEC statement. IOCP ignores the device(s); that is, it 
does not include them in the IOCDS. 


MODEL = model 
specifies the model number, if any, for the device. You specify one or two 
alphanumeric characters that represent the model number of the device. IOCP 
only checks the syntax for alphanumeric characters. IOCP does not validate the 
model value. 


PATH =chpid 
specifies the preferred channel path. You specify two hexadecimal digits that 
must correspond to a channel path identifier of an attaching channel path. 
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In 370-XA mode, the channel subsystem always attempts to use the preferred 
channel path to initiate I/O requests. The channel subsystem will attempt to 
initiate all I/O requests for the desired device using the specified preferred 
channel path first, before it attempts to initiate requests on any of the other | 
attaching channel paths. When operating in 370 mode, the processor complex 
ignores the preferred channel path. See “Preferred Path” in Chapter 1 for more 
information. 


TIMEOUT = 
specifies whether the eight-second I/O interface timeout function is to be active 
for the I/O interface tag sequences between the channel and I/O device. 


Y 
specifies that the I/O interface timeout function is to be active for all 
sequences on the I/O interface except as noted in Appendix C. With the 
timeout function active, if the I/O device fails to complete a tag sequence 
within eight seconds or a delay occurs in a dependent tag sequence that 
exceeds eight seconds, the channel terminates the I/O request to the I/O. 
device and generates an interface-control-check interruption. 


TIMEOUT = Y is the default if you do not code the TIMEOUT parameter. 


specifies that the I/O interface timeout function is to be inactive (timeout is 
inhibited) for some of the sequences on the I/O interface as described in 
Appendix C. With the timeout function inactive, the channel waits until the 
I/O device completes the tag sequence or initiates the next dependent 
sequence. TIMEOUT=N is not valid for I/O devices assigned to byte 
multiplexer channel paths. 


We recommend that you specify or use the default TIMEOUT =Y for all IBM 
I/O devices. However, for certain I/O devices, normal I/O sequences sometimes 
require more than eight seconds to complete. For example, some I/O sequences 
on a channel-to-channel (CTC) adapter might require more than eight seconds 
to complete. For these devices, you may chose to specify TIMEOUT=N. See 
Appendix C for additional information about the timeout function. 


Note: When operating in 370 mode, the TIMEOUT specification for the lowest 
device address on a shared control unit (SHARED=Y or SHARED = YB) 
overrides the timeout specification of the other devices connected to the same 
control unit. For example, device 1A0 connects to a shared control unit and has 
TIMEOUT =Y; device 1A1 connects to the same control unit and has 
TIMEOUT=N. In 370 mode, both devices are timed. In 370-XA mode, device | 
1A0 is timed; device 1A1 is not timed. | 


UNIT = device 
specifies the device type. You specify up to five alphanumeric characters to 
define the device type (such as, 3330 or 2540R). IOCP only checks the syntax 
for alphanumeric characters. IOCP does not validate the device value. For 
certain device types (such as 3350P), IOCP takes special actions. See Appendix 
D for more information. 


UNITADD = address 
specifies the physical unit address that is transmitted on the channel path to 
select the I/O device. You specify two hexadecimal digits in the range of 00 
through FF. These two hexadecimal digits must match one of the unit addresses 
specified on the UNITADD parameter of the CNTLUNIT macro instruction 
that defines the control units to which the device is assigned. 
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UNITADD allows you to assign a device number in the ADDRESS parameter 
on the IODEVICE macro instruction that does not have the actual physical unit 
address of the I/O device as the two rightmost digits of the device number. (The 
device number is the three hexadecimal digits specified in the ADDRESS 
parameter.) There may be situations when it is difficult or undesirable to assign 
device numbers that contain the physical unit address of the device. The 
UNITADD parameter allows you to assign a devicé number in the ADDRESS 
parameter on the IODEVICE macro instruction that does not have the physical 
unit address of the I/O device as the two rightmost digits of the device number. 
The UNITADD parameter that you specify becomes the physical unit address 
that the channel uses to address the selected device in both 370 and 370-XA 
mode. 


We recommend you specify the UNITADD parameter on the IODEVICE macro 
instruction only for an IOCDS that will be used exclusively for 370-XA mode 
operation. Operational and serviceability problems are likely to occur if you 
defined the IOCDS with UNITADD for use in 370 mode. 


If you specified a value for number in the ADDRESS parameter, that same 
number of sequential device numbers applies to the UNITADD parameter. 

However, the UNITADD parameter plus the number of device numbers (or 
device addresses) must not exceed a hexadecimal value of FF. 


Notes 
¢ If you use the UNITADD parameter, you must follow the same rules and 
restrictions that apply to the second and third digits of the ADDRESS 
parameter. For example, notes in Appendix D that apply to the unit address 
specified on the ADDRESS parameter also apply to the unit address specified 
on the UNITADD parameter. 


¢ For an MVS/370 system generation if you use the UNITADD parameter, you 
cannot use a combined input deck (IOCP and MVS system generation macro 
instructions). 


e If you specify the UNITADD parameter and use the IOCDS for 370 mode 
operation, the two digits specified in the UNITADD parameter replace the two 
rightmost digits of the device address. The UNITADD parameter changes the 
device address and makes it different from the device number. For example, 
ADDRESS = 180, UNITADD = 90 produces a device address (370 mode) of 190 
(if the device is connected to a channel path defined for 370 mode as channel 1). 
However, the device number (370-XA mode) is still 180. Thus, messages and 
error records for the same device will be issued using different device identifiers, 
190 in 370 mode and 180 in 370-XA mode. It is also possible that messages and 
error records for a device identifier (a device address or device number) could 
actually represent more than one device. 


Example: The following macro instruction defines a 2540 Card Read Punch Model 
1 with an address of 00D. It is attached to a 2821 Control Unit that has a control 
unit number of 10A. 


DEVOOD |} IODEVICE | ADDRESS=00D,CUNUMBR= 10A,MODEL = I, 
UNIT =2540P, TIMEOUT = Y 
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Example: The following macro instruction defines eight 3330 Disk Storage Model 1 
devices. The 3830 Storage Control has been assigned control unit number 11B and 
recognizes the device addresses/numbers of 210 through 217. 


DEV2DD | IODEVICE | ADDRESS = (210,8),CUNUMBR = 11B, 
MODEL = 1,UNIT = 3330, TIMEOUT = Y 


Example: The following macro instruction defines eight 3420 Magnetic Tape Units. 
The 3803 Tape Control has been assigned control unit number 0OE and recognizes 
the device addresses/numbers of D80 through D87. 


DEVDTT | IODEVICE | ADDRESS =(D80,8),CUNUMBR=00E, 
MODEL =3,UNIT = 3420, TIMEOUT = Y 


Example: The following macro instruction defines eight 3420 Magnetic Tape Units 
attached to two 3803 Tape Controls via the tape switching feature. The control 
units are assigned the numbers 01B and 01C. Both control units recognize the unit 
addresses of 40 through 47. (Note: In this case the control units must be attached to 
- different channel paths to ensure that unit addresses are not duplicated on the same 
channel path.) The channel number that corresponds to the lower numbered 
channel path to which the devices are assigned is C. 


DEVTUU| IODEVICE |} ADDRESS =(C40,8),CUNUMBR = (01B,010), 


* MODEL =3,UNIT = 3420, TIMEOUT = Y 


Example: The following macro instruction defines eight 3420 Magnetic Tape Units 
to MVS system generation for use only by processors other than the processor 
complexes listed on the cover of this manual. IOCP does not include the devices in 
the IOCDS. 


DEVTUX | IODEVICE | ADDRESS = (E80,8),CUNUMBR = ***, 
MODEL = 3,UNIT = 3420 


Example: The following macro instruction defines two 3350 I/O devices for use as 
paging devices by the 3880 Model 11 Paging Storage Subsystem. The 3880 Model 
11 Paging Storage Director has been assigned control unit number 14B. 


IOCP generates four device addresses/numbers for each 3350P (a 3350 used as a 
paging device by the 3880 Model 11): the base address as specified on the 
ADDRESS parameter, and three additional addresses at intervals of eight. 


This macro instruction causes IOCP to generate addresses 440, 448, 450, and 458 for 
base address 440, and addresses 441, 449, 451, and 459 for base address 441. 


DEV4DD | IODEVICE | ADDRESS=(440,2),CUNUMBR = 14B, 
| | UNIT=3350P, TIMEOUT = Y 
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Example: The following macro instruction defines eight 3420 Magnetic Tape Units. 
The 3803 Tape Control has been assigned the control unit number 530. The device 
numbers (for 370-XA mode) are 180 through 187. But the devices respond to the 
unit addresses of 90 through 97 (not 80 through 87) in both 370-XA mode and 370 
mode. Thus, the device addresses (for 370 mode) are actually 190 through 197. 


DEVIUA | IODEVICE | ADDRESS =(180,8),CUNUMBR = 530, 
| MODEL =3,UNIT = 3420, UNITADD = 90 
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Generating an IOCDS 


IOCP performs the following steps when you specify that you want to generate an 
IOCDS. 


Note: IOCP repeats steps 1 through 5 for each input macro instruction it reads 
(unless it finds an error as indicated in Steps 3 and 4). 


IOCP: 
1. Reads each macro instruction from the input device. 
2. Prints each macro instruction on the output printer. 


3. Checks the syntax of each macro instruction for correct format. If it finds a 
syntax error (such as a missing parenthesis), IOCP prints an error message on 
the output printer following the macro instruction that contains the error. IOCP 
stops checking the syntax of a macro instruction when it encounters the first 
syntax error on that macro instruction. If there are two or more syntax errors 
on a single macro instruction, IOCP finds the second and following errors on 
subsequent runs. 


If IOCP finds an error in Step 3, IOCP returns to Step 1 and continues reading, 
printing, and checking the syntax of the following macro instructions, but does 
not perform any of the following steps. 


4. Checks the validity of each macro instruction. For example, IOCP checks that a 
CNTLUNIT macro instruction specified a channel path previously defined on a 
CHPID macro instruction. If it finds an error, IOCP prints an error message on 
the output printer following the macro instruction that contains the error. 


If IOCP finds an error in Step 4, IOCP returns to Step 1 and performs only 
Steps | through 3 for the remainder of the macro instructions. If there are two 
or more validity errors in your input deck, IOCP finds the second and following 
errors on subsequent runs. 


5. Builds the appropriate identification, channel path, control unit, or I/O device 
record and enters the record into the IOCDS in storage. 


If more macro instructions remain to be read, IOCP returns to Step 1. 


After it processes all of the input macro instructions and enters all of the records 
into the IOCDS in storage, IOCP performs Step 6. 


6. Generates the IOCDS in storage and makes additional checks. For example, 
IOCP checks that the channel numbers within a channel set are consecutive. If 
IOCP finds an error, IOCP issues an error message and then terminates. 


After IOCP has successfully generated an IOCDS in storage, IOCP performs Step 7. 
7. Produces the IOCP configuration reports of the IOCDS generated in storage. 
If requested (by a WRTCDS option other than NO), IOCP performs Step 8. 


8. Writes the generated IOCDS from storage to one or more IOCDS(s) in the 
processor controller. This step requires permission from the system operator 
(via message ICPOSOD) before IOCP writes to the processor controller. 
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On the EXEC statement, you code the name of the IOCP program on the PGM 
parameter and the following PARM options in order to generate an IOCDS. (The 
examples later in this chapter describe the JOB and DD statements for an IOCP 
job.) 


Note: The defaults (on the PARM parameter) allow you to generate an IOCDS in 
storage and produce reports, but not write to the processor controller. 


‘IGNORE = YES|NO, 
WRTCDS= YES 
Ax 


Bx 
ABx 


NO, 
LINECOUNT = n/55’ 


IGNORE = 


YES 
specifies that IOCP is to ignore non-IOCP input macro instructions and 
non-IOCP parameters on the IODEVICE macro instruction. Except for the 
OPTCHAN parameter, which is an MVS system generation parameter on 
the IODEVICE macro instruction, IOCP processes and prints only IOCP 
input and indicates only those errors found on IOCP macro instructions and 
parameters. If OPTCHAN is coded, IOCP checks its syntax and uses the 
OPTCHAN value to test for a path from the device(s) to the alternate 
channel by which the device(s) can be addressed. 


If columns 1 through 5 contain *IOCP, IOCP prints the comment cards. 
YES is the default if you do not code IGNORE. 


Use IGNORE= YES when you have a combined input deck; that is, the 
deck contains both MVS system generation and IOCP macro instructions. 
Otherwise, IOCP will flag MVS system generation macro instructions as 
errors and prevent the generation of an IOCDS in storage. 


Also, use IGNORE = YES when defining, to MVS system generation, 
channels and I/O devices used only by processors other than the processor 
complexes listed on the cover of this manual. When you use card-image 
input and specify IGNORE= YES, IOCP does not include these channels 
and devices if you also: 


¢ Code ** instead of a chpid number on the PATH parameter of the 
CHPID macro instruction. 


° Code *** instead of a number on the CUNUMBR parameter of the 
IODEVICE macro instruction. 


Note: If you use IGNORE= YES and misspell an IOCP macro instruction 
name, IOCP assumes the macro instruction is not an IOCP macro 
instruction, ignores the macro instruction, and does not indicate an error. 
For example, if you specify an IODEVICE macro instruction as IDEVICE, 
IOCP does not indicate an error and does not define the device. However, 
note that MVS system generation processing will indicate an error because a 
misspelled macro instruction name is not a valid system generation or IOCP 
macro instruction name. 
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NO 
specifies that IOCP is to process all input macro instructions and 
parameters. [OCP flags non-IOCP input as errors and also indicates errors 
found on IOCP macro instructions and parameters. IOCP prints all input, 
including all comment cards (all cards with an * in column | ora .* in 
columns | and 2). 


Use IGNORE=NO when your input deck contains only IOCP macro 
instructions, [OCP-related parameters on the IODEVICE macro instruction, 
and comment cards. 


Note: If you use a combined input deck, IGNORE=NO prevents the 
generation of an IOCDS in storage. Using IGNORE=NO causes flagging 
of the MVS system generation macro instructions as errors. If you use 
IGNORE = NO, IOCP assumes a default value of 1 when the number of 
units is not specified in the IODEVICE macro. Appendix D lists the default 
number of units assigned by IOCP when using IGNORE=YES. If you do 
not use IGNORE= YES, be certain you have specified the correct number 
of units when you write the IOCDS. See the IODEVICE macro for other 
implications of the IGNORE parameter. 


WRTCDS = 
specifies specifies whether or not IOCP is to write an IOCDS generated in 
storage to one or more IOCDS(s) in the processor controller of the processor 
complex. All of the WRTCDS options except NO cause [OCP to write an 
IOCDS. 


IOCP writes the IOCDS only if: 


¢ It finds no errors on the input macro instructions 

e It encounters no errors during IOCP processing of the IOCDS in storage 
¢ The system operator grants permission in response to message ICP050D 
¢ You did not write-protect the IOCDS (see the IOCDSM frame) 


You request [OCP to write the IOCDS only after you have (1) checked the 
syntax of the input macro instructions, (2) generated an IOCDS in storage, (3) 
received reports on the generated IOCDS, and (4) checked to see whether or not 
the I/O configuration generated by IOCP is correct. If you want to write to an 
IOCDS that is write-protected, you must also remove the write-protection using 
the IOCDSM (SYS021) frame. 


When IOCP writes the generated IOCDS to an JOCDS in the processor 
controller, it overlays the previous configuration data in that IOCDS. The data 
in that IOCDS is lost, even if that IOCDS is the active IOCDS. (The IOCDS 
used for the last power-on reset or SYSIML CLEAR is the active IOCDS). 


The valid options for WRTCDS depend on the number of I/O configuration 
data sets that your processor complex supports: 


* For two I/O configuration data sets (LVLO and LVL1), the valid options are 
YES, Al, and NO. 


¢ For four I/O configuration data sets, the valid options on the A side are 
YES, Ax, and NO; on the B side they are YES, Bx, and NO. 


¢ For eight I/O configuration data sets, all of the options are valid. 


YES 
specifies that IOCP is to write the IOCDS generated in storage to the Al 
IOCDS (or the LVL1 IOCDS) in the processor controller. 
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Ax 
specifies that IOCP is to write the Ax IOCDS (where x is 0, 1, 2, or 3) 
generated in storage to the level x IOCDS in the processor controller on the 
A side. 


specifies that IOCP is to write the Bx IOCDS (where x is 0, 1, 2, or 3) 
generated in storage to the level x IOCDS in the processor controller on the 
B side. 


ABx 
specifies that IOCP is to write the x IOCDS (where x is 0, 1, 2, or 3) 
generated in storage to the level x IOCDS in the processor controller on 
both the A side and the B side. 


NO 
specifies that IOCP can not write the IOCDS generated in storage to an 
IOCDS in the processor controller. 


NO is the default if you do not code WRTCDS. 


Code or use the default WRTCDS = NO when you are testing the input deck 
and do not want to write to the processor controller until you have 
successfully tested and checked the input deck. Also, you must code or use 
the default WRTCDS=NO when you are executing IOCP on a processor 
other than the processor complexes listed on the cover of this manual. 


LINECOUNT = 


n 
specifies the number of lines that IOCP is to print on a page of the IOCP 
output listing and configuration reports, including the heading of the report. 
You code a decimal value in the range of 10 through 99. 


is the default number of lines (including the heading) that IOCP prints on a 
page of the IOCP output listing and configuration reports. 


JCL Examples of Generating an IOCDS 
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Example 1: The following example shows the JCL statements used to check an 
input deck containing only IOCP macro instructions. IOCP requires the ddnames 
SYSIN for the input data set and SYSPRINT for the output data set. IOCP sends 
reports to SYSOUT. 


//TOCP1 JOB REGION=300K 
//TEST1 EXEC PGM=ICPIOCP, PARM='IGNORE=NO,WRTCDS=NO, 


// LINECOUNT=60 ' 
//SYSIN DD DSNAME=USER. IOCD1.CARDS,DISP=SHR 
//SYSPRINT DD SYSOUT=A, DCB=(RECFM=FA) 
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In the example: 


IOCP1 


TEST1 


SYSIN 


SYSPRINT 


specifies the JOB statement. Code parameters on the JOB statement 
required by your installation. Use a region size of 300K to ensure 
sufficient space for the job. 


specifies the EXEC statement and the program (ICPIOCP) to be 
executed. The PARM options are: IGNORE=NO, which specifies 
flagging of non-IOCP input as errors; WRTCDS=NO, which 
specifies that the IOCDS generated in storage is not to be written to 
the processor controller; LINECOUNT = 60, which specifies 60 lines 
of output on the reports IOCP produces. 


specifies the DD statement that defines the input data set, which 
consists of macro instructions with a record length of 80 bytes. 


specifies the DD statement that defines the output data set to receive 
messages and reports. (Note that IOCP records contain ANSI device 
control characters and have a length of 133 bytes.) 


Example 2: The following example shows the JCL statements used to process a 
combined input deck, generate an IOCDS, and write the generated IOCDS to the AO 
IOCDS in the processor controller. IOCP sends reports of the generated IOCDS to 


SYSOUT. 


IOCP requires the ddnames SYSIN for the input data set and SYSPRINT for the 
output data set. 


//10CP2 
//WRITE1 


//SYSIN 


JOB REGION=300K 
EXEC PGM=ICPIOCP,PARM='WRTCDS=A0' 
DD DSNAME=USER. [0CD2.CARDS,DISP=SHR 


//SYSPRINT DD SYSOUT=A , DCB=(RECFM=FA) 


In the example: 


IOCP2 


WRITE 


SYSIN 


SYSPRINT 


specifies the JOB statement. Code parameters on the JOB statement 
required by your installation. Use a region size of 300K to ensure 
sufficient space for the job. 


specifies the EXEC statement and the program (ICPIOCP) to be 
executed. The PARM options are: WRTCDS=AO, which specifies 
that the IOCDS generated in storage is to be written to the AO 
IOCDS in the processor controller; IGNORE= YES (the default), 
which specifies that IOCP is to ignore non-IOCP macro instructions 
and parameters, LINECOUNT =55 (the default), which specifies the 
number of lines of output for each page on the configuration reports. 


specifies the DD statement that defines the input data set, which 
consists of macro instructions with a record length of 80 bytes. 


specifies the DD statement that defines the output data set to receive 
messages and reports. (Note that IOCP records contain ANSI device 
control characters and have a length of 133 bytes.) 
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Producing Configuration Reports 


IOCP performs the following steps when you request configuration reports. 


IOCP: 


¢ Reads one or more IOCDS(s) from the processor controller into storage. 
e¢ Prints the IOCP configuration reports. 


If IOCP encounters any errors during processing, IOCP sends appropriate error 
messages to the output printer. For examples of IOCP configuration reports, see 
“Chapter 5. IOCP Configuration Reports”. 


Coding the JCL EXEC Statement for Producing Configuration Reports 
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On the EXEC statement, you code the name of the IOCP program on the PGM 
parameter and the following PARM options to produce configuration reports. (The 
example later in this chapter describes the JOB and DD statements for an IOCP 
job.) 


You must code the REPORT option in order to receive reports of an IOCDS. 


PARM = REPORT = 


Bx 


B 
AB), LINECOUNT =n 
35 


REPORT = 
specifies one or more IOCDS(s) to be read from the processor controller into 
storage in order to produce configuration reports. You can code more than one 
REPORT option. If you code only one option, you:can omit the parentheses. 
The valid options for REPORT = depend on the number of I/O configuration 
data sets that your processor complex supports: 


¢ For two I/O configuration data sets (LVLO and LVL1), the valid options are 
CD0, AO, CD1, Al, and BOTH. 


¢ For four I/O configuration data sets, the valid options on the A side are 
CD0, CD1, BOTH, Ax, and A; on the B side they are CDO. 


¢ For eight I/O configuration data sets, all of the options are valid. 
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CDO 
specifies the AO IOCDS. 


CDi 
specifies the Al IOCDS. 
BOTH 
specifies both the AO and the Al IOCDS. 
Ax 
specifies the Ax IOCDS, where x is 0, 1, 2, or 3. 
Bx 
specifies the Bx IOCDS, where x is 0, 1, 2, or 3. 
A 
specifies the entire A side (the AO, Al, A2, and A3 IOCDS). 
B 
specifies the entire B side (the BO, B1, B2, and B3 IOCDS). 
AB 
specifies every IOCDS on both the A side and the B side. 
LINECOUNT = 
n 


specifies the number of lines that IOCP is to print on a page of the IOCP 
output listing and configuration reports, including the heading of the report. 
You code a decimal value in the range of 10 through 99. 


is the default number of lines (including the heading) that IOCP prints on a 
page of the IOCP output listing and configuration reports. 


Conditions for Coding the REPORT Option 
e You can code REPORT only when you execute IOCP on a 308x processor 
complex because you must read an IOCDS from the processor controller. 


« You cannot code REPORT if you code either the IGNORE or WRTCDS 
option. That is, you cannot read an input deck and generate an IOCDS (which 
includes reports of the generated IOCDS), and produce reports via the REPORT 
option in the same job. 


e You can code several REPORT options. IOCP does not allow redundant and/or 
duplicate values. For example, 
REPORT =(A0,A1,A2,A3,BOTH,CD0,CD1,A0,B) is the same as 
REPORT =(A,B) or REPORT=AB. Regardless of the order in which you 
specify the options, the reports are always »roduced, if they are specified, in the 
following order: AQ, Al, AZ, A3, BO, .... 
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JCL Example of Producing Configuration Reports 
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Example: The following example shows the JCL statements used to produce IOCP 
reports of the AO and Al IOCDS in the processor controller. IOCP sends reports to 
SYSOUT. Note that you do not need a DD statement to access an IOCDS in the 
processor controller. IOCP requires the ddname SYSPRINT for the output data set. 


//TOCP5 JOB REGION=300K 


//REPORT2 EXEC PGM=ICPIOCP,PARM='REPORT=BOTH ' 
//SYSPRINT DD SYSOUT=A, DCB=(RECFM=FA) 


In the example: 


IOCPS specifies the JOB statement. Code the parameters on the JOB 
statement required by your installation. Use a region size of 300K to 
ensure sufficient space for the job. 


REPORT2 specifies the EXEC statement and the program (ICPIOCP) to be 
executed. The PARM option of REPORT =BOTH specifies that 
both the AO and the Al IOCDS are to be read from the processor 
controller to produce reports. 


SYSPRINT _ specifies the DD statement that defines the output data set to receive 
messages and reports. (Note that IOCP records contain ANSI device 
control characters and have a length of 133 bytes.) 
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Return Codes 


When you execute the MVS version of IOCP, IOCP returns one of the following 
codes at the completion of the job. 


Return Code shag Code Description/ Action 

Decimal 
IOCP completed the requested function 
without error. 


IOCP completed the requested function 
without error, but has issued one or more 
warning messages. The warning messages in 
the output listings or the reports describe the 
specific conditions. 


IOCP encountered an error and has 
terminated processing before completing the 

requested function. The error message in the 

output listing describes the specific condition. 


IOCP terminated because the output data set 
DCB failed to open. IOCP was unable to 
print messages or reports. You must 
correctly specify the DD statement for the 
output data set. 


IOCP terminated because it could not obtain 
\ the needed storage via the GETMAIN macro 
instruction. Use a region size of 300K bytes 
(on the REGION parameter of the JOB 
statement) to ensure sufficient space for the 
| job. If the region size is correct, and MVS is 
| running as a guest under VM, a special 
| GETMAIN from subpool 245 may have 
failed. See your System Programmer. 
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Methods of Executing the MVS Version of IOCP 


This topic suggests the steps that the installation can use to execute the MVS version 
of IOCP in order to (1) initially define and check the I/O configuration data to 
prepare for a new processor complex, and (2) subsequently redefine and replace an 
I/O configuration on an installed processor complex. 


Initial Definition of I/O Configuration Data 
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Note: This example applies to releases of MVS prior to MVS SP 2.2.0. MVS SP 
2.2.0 provides the MVS Configuration Program (MVSCP) which provides functions 
that were performed by SYSGEN. See MVS/Extended Architecture: MVS 
Configuration Program Guide and Reference for information on how to use MVSCP. 


The following example describes the steps that an installation can use to initially 
define and check the I/O configuration data in order to prepare for the installation 
of a new processor complex. The example suggests that you develop a combined 
card-image input deck (consisting of IOCP and MVS system generation macro 
instructions) and check the deck on an existing system. The customer engineer (CE) 
uses this input deck to generate the I/O configuration data during the installation of 
the new processor complex. 


1. Determine, from your physical plan, the I/O configuration requirements that 
must be met to install the processor complex. 


2. Prepare a combined input deck (containing both IOCP and system generation 
macro instructions) that defines your I/O configuration and system requirements. 
You use this deck for both IOCP execution and MVS system generation, as 
described in the following steps. (Appendix B shows a listing of a typical input 
deck containing both IOCP and system generation macro instructions.) 


Validate the IOCP macro instruction input by executing IOCP on the generating 
system before executing the complete system generation, which will use the same 
input deck. This allows you to correct IOCP-related errors in the input deck before 
doing the system generation. 


During your preparation for an MVS system generation, perform the following steps 
(3, 4, 5, and 6) after you have loaded the distribution libraries (via the SMP 
procedure) and before you execute Stage | of the system generation. The 
SYS1.AOSCS data set of the distribution library (DLIB) contains the IOCP 
program. The program name is ICPIOCP. 


During the SMP procedure, IOCP is link edited from the DLIB into 
SYS1.LINKLIB as an APF-authorized program (authorization code AC=1) with 
the load module name of ICPIOCP. 


3. If you want, you can link-edit the IOCP program from the DLIB into one of 
your private libraries in the generating system. The program must be link edited 
into a single load module. The program does not need to be authorized to 
perform the rest of the steps in this example. The 15 CSECTs to be included 
are: ICPCARDS, ICPCARDX, ICPCGET, ICPCGNDS, ICPCINIT, 
ICPCIOCP, ICPCIOCU, ICPCIODV, ICPCMSG, ICPCPUT, ICPCRDDS, 
ICPCRPT, ICPCRTNS, ICPCWTDS, and ICPPCNTL. Use ICPPCNTL for 
the entry point in the ICPIOCP load module to receive control. 


_ Note: The IOCP program used in Step 4 does not need to be an authorized 
program. You may want to keep this non-authorized program to validate 
subsequent I/O configuration input decks. 
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4. Execute IOCP via JCL statements to validate the [OCP macro instructions. On 
the PARM parameter of the EXEC statement, use IGNORE= YES and 
WRTCDS=NO. 


5. If there are any errors in the IOCP macro instructions, correct the errors and 
rerun IOCP (Step 4). 


6. Analyze the IOCP configuration reports (produced in Step 4) to ensure that you 
defined the desired I/O configuration. If necessary, revise the IOCP macro 
instructions and rerun IOCP. 


7. Execute the MVS system generation for the MVS/System Product and use the 
input deck created in Step 2 and processed by IOCP in Step 4. 


Note: During the MVS system generation, IOCP is link edited from the DLIB 
into SYSI.LINKLIB of the generated system as an APF-authorized program 
(authorization code AC = 1) with the load module name of ICPIOCP. You can 
use this APF-authorized program to subsequently replace I/O configuration data 
in an IOCDS as described in “Subsequent Definition and Replacement of I/O 
Configuration Data”. Also, for additional security, you may want to change the 
name of the IOCP program or move the program to another data set and 
password-protect or RACF-protect the data set. This added protection will 
reduce the possibility of having the I/O configuration data in an IOCDS 
inadvertently destroyed. 


8. If IOCP encounters errors during the system generation, correct the errors. If 
the errors involve IOCP-related macro instructions (CHPID or IODEVICE), 
rerun IOCP (Steps 4, 5, and 6) to ensure that the corrections have not affected 
IOCP processing. Then rerun the appropriate portions of system generation. 


9. Save the validated input deck for use by the CE during installation of the 
processor complex. 


Note: During the physical installation of the processor complex, the CE uses 
your validated input deck (with the stand-alone version of IOCP) to configure 
and test the I/O configuration for the new processor complex. “Generating an 
IOCDS on a New Processor Complex” in Chapter 4 provides an example for the 
CE. 


Subsequent Definition and Replacement of I/O Configuration Data 
Note: This example applies to releases of MVS prior to MVS SP 2.2.0. MVS SP 
2.2.0 provides the MVS Configuration Program (MVSCP) which provides functions 
that were performed by SYSGEN. See MVS/Extended Architecture: MVS 
Configuration Program Guide and Reference. 


The following example describes the steps the installation can use to replace the 

existing I/O configuration data on a processor complex. You use this procedure 
when the I/O configuration for your processor complex changes and you need to 
execute IOCP and perform an MVS system generation. 
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You can do steps | through 6 on an existing system (such as a 3033) that has an 
MVS/System Product installed. 


lL. 


Update your combined input deck that contains the IOCP and MVS system 
generation macro instructions to reflect your new I/O configuration. 


. Execute the MVS version of IOCP (either an APF-authorized or non-authorized 


IOCP program) to check the input deck you updated in Step 1. On the PARM 
parameter of the EXEC statement, use the IGNORE = YES and 
WRTCDS=NO options. . . 


. If necessary, correct any errors on the IOCP macro instructions, and rerun IOCP 


(Step 2). 


. Analyze the IOCP configuration reports (produced in Step 2) to ensure that you 


defined the desired I/O configuration. If necessary, revise the IOCP macro 
instructions and rerun IOCP (Step 2). 


. Execute the complete system or I/O device generation using the input deck 


prepared and checked in Steps 1 through 4. 


. If IOCP encountered errors during system generation, correct the errors. If the 


errors involve IOCP-related macro instructions (CHPID or IODEVICE), rerun 
IOCP (Steps 2, 3, and 4) to ensure that the corrections have not affected IOCP 
processing. Then rerun the appropriate portions of system generation. 


You must perform the following steps on the processor complex that is to have its 
IOCDS initialized. 


fs 


10. 


Execute an APF-authorized IOCP program with the IGNORE=YES and a 
WRTCDS option other than NO. IOCP writes the I/O configuration to the 
specified IOCDS in the processor controller. Note that the system operator 
must respond YES to IOCP message ICP0S0D before IOCP writes to the 
processor controller. 


. Perform a power-on reset of the processor complex with the appropriate IOCDS 


specified as the source of your configuration data. You use the IOCDSM 
(SYS021) frame to select the IOCDS and the CONFIG (SYS020) frame to 
perform the power-on reset. (See the operator’s guide for the system console 
that applies to your processor complex.) 


. Test the new configuration following the procedures established for your 


installation. 


If your processor complex has only a level AO and Al (LVLO and LVL1) 
IOCDS, switch them after testing the new I/O configuration. To switch data 
sets, use action 3 (SWITCH DS A/B) on the CONFIG (SYS020) frame. This 
action allows you to execute IOCP again and write to and test another I/O 
configuration in the Al IOCDS. 


. Save the card-image input you used in Step 2 to provide a backup. 
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The VM version of IOCP runs under the control of: 


¢ the VM/System Product (VM/SP) 
¢ the VM/SP High Performance Option (VM/SP HPO) 
¢ the VM/Extended Architecture Systems Facility (VM/XA Systems Facility) 


You invoke the VM version of IOCP in the CMS environment. The CMS IOCP 
command executes IOCP and has options that allow you to request the following 
IOCP functions: 


¢ Generating an IOCDS - IOCP reads, validates, and checks the syntax of the 
input macro instructions. It generates an IOCDS in storage based on the 
configuration defined by the macro instructions and produces reports of the 
IOCDS generated in storage. When requested, IOCP writes the generated 
IOCDS to one or more IOCDS(s) in the processor controller. 


¢ Producing Configuration Reports - IOCP reads one or more IOCDS(s) from the 
processor controller into storage and prints the IOCP configuration reports. 
(See “Chapter 5. IOCP Configuration Reports” for examples.) 

The following topics describe: 

¢ How to specify IOCP macro instructions 

¢ The two functions IOCP performs 

¢ The CMS IOCP command that invokes these functions (with examples) 

e The return codes IOCP can set 


¢ How to initially define the I/O configuration or to redefine an existing I/O 
configuration 


© Copyright IBM Corp. 1980, 1989 Chapter 3. Executing the VM Version of IOCP 3-1 


Specifying I|OCP Macro Instructions 


This section describes the purpose of the IOCP macro instructions and explains how 
to code them. The first topic in this section summarizes the I/O configuration rules 
that apply to the IOCP macro instructions. Subsequent topics describe the IOCP 
macro instructions in alphabetic order. 


The rules for coding the IOCP card-image macro instructions are those of assembler 
language. See “Appendix A. Coding IOCP Macro Instructions” for a summary of 
the rules for coding the macro instructions and the notation used in this book to 
illustrate the macro instructions. 


IOCP has four macro instructions: CHPID, CNTLUNIT, IODEVICE, and ID. 
IOCP requires the CHPID, CNTLUNIT, and IODEVICE macro instructions. The 
CHPID, CNTLUNIT, and IODEVICE macro instructions define respectively, the 
channel paths, control units, and I/O devices in your configuration. The ID macro 
instruction is optional. If you want specific identifying information in the heading of 
the IOCP configuration reports, code the ID macro instruction. 


The following general rules apply to the sequence of the IOCP macro instructions in 
the input file. 


¢ You can code the ID macro instruction only once and it must precede other 
IOCP macro instructions. 


¢ A CHPID macro instruction that defines the channel path must precede a 
CNTLUNIT macro instruction that refers to the channel path. 


* ACNTLUNIT macro instruction must follow the CHPID macro instruction 
that defines the channel path to which the contro] unit attaches. 


¢ An IODEVICE macro instruction must follow the CNTLUNIT macro 
instruction that defines the control unit to which the device is assigned. 


¢ You can insert IOCP comment cards, specified by the characters *IOCP in 
columns | through 5, in the input file where desired. 


We suggest that you group all CHPID macro instructions together, followed by all 
CNTLUNIT macro instructions, and then all IODEVICE macro instructions (as 
shown in Figure B-3). Or, you might group all CHPID macro instructions together, 
followed by groups of related CNTLUNIT and IODEVICE macro instructions. 


IOCP and VM/SP (or VM/SP HPO) System Generation 


The information on some VM/SP (or VM/SP HPO) system generation macro 
instructions must correspond to IOCP macro instructions. Figure 3-1 shows that 
correspondence. This chapter contains detailed information about the 
correspondence between VM/SP and VM/SP HPO system generation macro 
instructions and IOCP macro instructions. 


Do not mix IOCP macro instructions and VM/SP (or VM/SP HPO) system 


generation macro instructions in the same file. You must maintain two distinct files, 
the IOCP source file and the corresponding real I/O configuration file (DMKRIO). 
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“Remote Display Stations | IOCP Macro Instructions 


System Generation Macro Instructions 


1. ID macro instruction (optional) defines heading data, or titles, 
for configuration reports. IOCP allows only one ID macro instruction. 
2. CHPID macro instructions (required) define channel paths. You can 
define up to 8 channel paths on each CHPID macro instruction. 
The information on the CHPID macro instructions must correspond 
to the information on the RCHANNEL macro instructions in the 
DMKRIO file. 

. CNTLUNIT macro instructions (required) define control units. You must 
define each control unit on a separate CNTLUNIT macro instruction. 
The information on the CNTLUNIT macro instructions must correspond 
to the information on the RCTLUNIT macro instructions in the 
DMKRIO file. 

. IODEVICE macro instructions (required) define I/0 devices. You can 
define up to 256 1/0 devices on an IODEVICE macro instruction. 

The information on the IODEVICE macro instructions must 
correspond to the information on the RDEVICE macro instructions 
in the DMKRIO file. 


Figure 3-1. Correspondence between IOCP Macro Instructions and DMKRIO Macro Instructions 
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IOCP and VM/XA Systems Facility System Generation 
The information on some VM/XA Systems Facility system generation macro 
instructions must correspond to IOCP macro instructions. Figure 3-2 shows that 
correspondence. This chapter contains detailed information about the 
correspondence between VM/XA Systems Facility system generation and IOCP 
macro instructions. 


Do not mix IOCP and VM/XA Systems F acility system generation macro 


instructions in the same file. You must maintain two distinct files, the IOCP source 
file and the corresponding real I/O configuration file (HCPRIO). 
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System Generation Macro Instructions 


OCP Macro Instructions 


. ID macro instruction (optional) defines heading data, or titles, 


for configuration reports. IOCP allows only one ID macro instruction. 


. CHPID macro instructions (required) define channel paths. You can 


define up to 8 channel paths on each CHPID macro instruction. 
A VM/XA Systems Facility system generation does not use a 
corresponding macro instruction. 


. CNTLUNIT macro instructions (required) define control units. You must 


define a control unit on a separate CNTLUNIT macro instruction. 
A VM/XA Systems Facility system generation does not use a 
corresponding macro instruction. 


. IODEVICE macro instructions (required) define 1/0 devices. You can 


define up to 256 1/0 devices on an IODEVICE macro instruction. 
The information on the IQDEVICE macro instructions must 
correspond to the information on the RDEVICE macro instructions 
in the HCPRIO file. 


Figure 3-2. Correspondence between IOCP Macro Instructions and HCPRIO Macro Instructions 
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Summary of Configuration Rules 


Here for your convenience is a summary of the rules and restrictions described in the 
following topics: 


For channel paths 


For control units 
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You can specify all channel paths as block multiplexer. 


You can specify for the A side, only channel paths 00, 01, 02, 03, 10, 11, 12, and 
13 (hex) byte multiplexer. 


For the B side, you can specify only channel paths 40, 41, 42, 43, 50, 51, 52, and 
53 (hex) as byte multiplexer. 


You can specify a maximum of four channel paths on each side as byte 
multiplexer. 


You can attach a physical control unit to a maximum of four channel paths per 
system. 


You can assign a maximum of 16 control units to one channel path. 


You can attach only a nonshared control unit (specified by SHARED=N on the 
CNTLUNIT macro instruction) to a channel path that operates in byte 
multiplexer mode. 


Only a control unit attached to a block multiplexer channel path can use the 
data streaming interface protocol. That is, if PROTOCL=S or S4 on the 

CNTLUNIT macro instruction, the channel path(s) to which the control unit 
attaches must have TYPE=BL specified on the CHPID macro instruction(s). 


When you are running IOCP to verify the card-image input deck, 
(WRTCDS=NO), IOCP allows a maximum of two channel paths per data 
server element (DSE) to attach to physical control units that have 

PROTOCL =S4. Likewise, when generating an IOCDS on a Model X 
processor, IOCP allows a maximum of two channel paths per DSE to attach to 
physical control units that have PROTOCL=S4. However, when generating an 
IOCDS on a processor that is not a Model X, IOCP restricts the channel paths 
that can attach to the physical control unit that has PROTOCL=S4. This 
control unit can attach only to channel paths with the following identifiers: 06, 
07, 16, 17, 26, 27, 46, 47, 56, 57, 66, and 67. For a pictorial description of data 
server elements, see Figures 1-1 and 1-2 in Chapter 1. 
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For 1/O devices 


For 370-XA mode 
If you plan to create an IOCDS for VM/SP or VM/SP HPO and the VM/XA 
Systems Facility or another operating system that supports extended architecture, the 
following apply: 


The maximum number of I/O devices is 4080. 


The sum of the number of I/O devices plus the number of logical control units 
cannot exceed 4096. 


You can assign a maximum of 256 I/O devices to one channel path. 
You can assign a device to a maximum of four control units. 


When you assign a device to more than one control unit, each control unit must: 
(1) recognize the same unit address for the device, (2) not be attached to the 
same channel path, and (3) have the same shared characteristics and use the 
same interface protocol. 


You can only assign a device to a combined maximum of four channel paths 
(even though you can assign a device to up to four control units and you can 
attach a control unit to up to four channel paths). 


You cannot assign a device that has the I/O interface timeout function inhibited 
to a channel path that operates in byte multiplexer mode. 


Each I/O device must have a unique device address/number within the I/O 
configuration. IOCP does not allow duplicate device addresses/numbers. 


¢ If you code a file of IOCP macro instructions for the 370 level of IOCP, you can 


use the same file as input to create a 370/370-KA IOCDS. (However, the 
operating system that supports extended architecture may not support all of the 
defined devices. 


¢ You can define a channel path and its attached I/O devices exclusively for 


370-XA mode. To do this, remove the channel number and channel set for that 
channel path from the CHPID macro instruction. 


The PATH parameter on the IODEVICE macro instruction specifies a preferred 
path. The preferred path is an optional parameter used only for 370-XA mode 
operation. 
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CHPID 


CHPID, a required macro instruction, describes: 


¢ The characteristics of channel paths 
¢ The correspondence of channel paths to channel numbers and channel sets 


You must specify each channel path in your I/O configuration on a CHPID macro 
instruction to use the channel path. You can specify up to eight channel paths on 
one CHPID macro instruction. 


The CHPID macro instruction must follow the ID macro instruction (if you 
specified the ID macro instruction). The CHPID macro instruction must precede any 
CNTLUNIT macro instructions that refer to the channel path. 


The format of the CHPID macro instruction is: 


[symbol] | CHPID PATH = ((chpid number[,channel number 
[,channel set]]),...) 


TYPE = {BL|BY} 


PATH= 
specifies one or more channel path identifiers. If you use the devices on a 
channel path in 370 mode, you must specify the channel path’s corresponding 
channel number. Optionally, you may specify the channel path’s associated 
channel set. You can specify a maximum of eight channel paths on one CHPID 
macro instruction. If you specify more than one channel path on a macro 
instruction, all channel paths must have the same TYPE characteristic. You 
cannot specify a channel set without specifying a channel number. 


chpid number 
specifies the channel path identifier. For the A side, you must specify two 
hexadecimal digits in the range of 00 through 07, 10 through 17, or 20 
through 27. (Channel paths 10 through 17 and 20 through 27 are optional 
by model.) For the B side, you must specify two hexadecimal digits in the 
range of 40 through 47, 50 through 57, or 60 through 67. . 


channel number 
specifies the channel number that corresponds to the channel path when the 
processor complex operates in 370 mode. You specify one hexadecimal digit 
in the range of 0 through F. Channel numbers must be unique and 
consecutive within a channel set. 


To specify a channel set, you must specify a channel number. If you do not 
specify the channel number, you cannot access the devices attached to the 
channel path when the processor complex operates in 370 mode. 


For a system on which you generate VM/SP or VM/SP HPO: To code the 
channel number, first find the real address of the channel as specified on the 
ADDRESS parameter of the RCHANNEL macro instruction in the 
DMKRIO file. This value is the channel number. 
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For example, the following macro instruction was coded for the DMK RIO 
file: 


RCHANNEL ADDRESS=2,... 


The corresponding IOCP macro instruction is: 


CHPID PATH=((17,2,0)),... 


channel set 
specifies the channel set used for 370 mode. You specify a value of 0 or 1 
for the channel set. If you do not specify a channel set, IOCP assigns the 
channel path to channel set 0. On a processor complex with both an A side 
and a B side, each side has two channel sets (0 and 1) in 370 mode. 


On the uniprocessors, VM/SP and VM/SP HPO can access only channel 
paths assigned to channel set 0. Therefore, you must either specify a value 
of 0 or accept the default of 0. (You can assign channel paths to channel set 
1; however, neither VM/SP and VM/SP HPO, nor any of their virtual 
machines, can access these channel paths on a uniprocessor.) A channel set 
cannot have more than 16 channel paths assigned to it. The two channel 
sets (0 and 1) can have a maximum combined total of 24 channel paths on 
each side. (For example, 16 channel paths assigned to channel set 0 and 8 
channel paths assigned to channel set 1, or 12 channel paths assigned to 
channel set 0 and 12 channel paths assigned to channel set 1.) For the 
processor complex, you must assign consecutive channel numbers within a 
channel set. (For example, channel numbers 0, 1, 2, 3, 4, 5, or channel 
numbers 8, 9, A, B, C, D.) The channel path identifiers do not need to be 
consecutive. For a uniprocessor, processor 2 (the only processor) always 
connected to channel set 0 at power-on reset, SYSIML or SYSIML 
CLEAR. For a processor complex with more than one processor, channel 
set connection at power-on reset, SYSIML or SYSIML CLEAR depends on 
whether the processor complex has one or both processors configured. 
When the processor complex has both processors configured, channel set 0 
connects to processor 0, and channel set 1 connects to processor 2. (If the 
processor complex has a B side, channel set 0 on the B side connects to 
processor 1, and channel set 1 on the B side connects to processor 3.) When 
the processor complex subsequently resets (such as a system reset or load), 
channel set 0 reconnects to processor 0 (or processor 1 on the B side) and 
channel set | reconnects to processor 2 (or processor 3 on the B side). 
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If you remove either processor from the processor complex (the processor 
fails or you take it offline), channel set 0 and channel set 1 both remain 
configured. However when you remove a processor, a subsequent reset 
causes the connection of channel set 0 to the remaining processor on that 
side. The reset does not connect channel set 1, but you can connect channel 
set | after IPL by activating channel set switching. Therefore, we 
recommend that you assign critical asymmetrically attached devices (such as 
the operator’s console) to a channel path assigned to channel set 0. 


TYPE= 

specifies the mode of I/O operation for the channel path. If you specify more 
than one channel path on a macro instruction, all channel paths must have the 
same TYPE characteristic. 


BL 
specifies that the channel path is a block multiplexer channel, which operates 
in burst mode only and allows multiplexing between blocks. You can 
specify TYPE =BL for all channel paths. 


BY 
specifies that the channel path is a byte multiplexer channel, which operates 
in burst mode or byte-interleave mode, depending on the attached control 
unit. You can specify TYPE=BY for only channel paths 00 through 03 and 
10 through 13 (hex) on the A side, and for channel paths 40 through 43 and 
50 through 53 (hex) on the B side. You can specify a maximum of four 
channel paths on each side as TYPE=BY. 


For a system on which you generate VM/SP or VM/SP HPO: Code TYPE=BL on 
the CHPID macro instruction for CHTYPE =SELECTOR on the RCHANNEL 
macro instruction in the DMKRIO file. Although SELECTOR has no 
corresponding value on the CHPID macro instruction, the channel operates in the 
selector mode if you code SHARED=Y on the CNTLUNIT macro instruction. See 
the description of the CNTLUNIT macro instruction in this chapter. 


| Example: The following macro instruction (named CHSET1) defines three channel 


paths (hex 15, 16, and 17) with their corresponding channel numbers (hex 8, 9, and 
A) in channel set 1. The channel paths are to operate in block multiplexer mode. 


CHSET1 | CHPID | PATH=((15,8,1),(16,9,1),(**,A,1)), TYPE = BL 


Note that the three channel path identifiers are unique numbers arbitrarily assigned. 


Example: The following macro instruction (named CHP17) defines channel path 17. 
The channel path operates in block multiplexer mode. Because you did not specify a 
channel number, the processor complex can access the devices attached to this 
channel path only when it operates in 370-XA mode. 


CHP17 CHPID PATH =17,TYPE=BL 
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CNTLUNIT 


CNTLUNIT, a required macro instruction, describes: 


e The characteristics of the control unit 
¢ The channel paths to which the control unit attaches 
¢ The unit addresses the control unit recognizes 


You must specify each physical control unit in your I/O configuration in a separate 
CNTLUNIT macro instruction to use the control unit. This requirement includes 
control units residing either in the same physical unit as an I/O device or another 
control unit. 


You can attach a control unit to a maximum of four channel paths. You can assign 
a maximum of 16 control units to one channel path. 


See Appendix D for a list of control unit types and their characteristics. 


Based on information in the CNTLUNIT macro instructions, [OCP constructs 
logical control units for the channel subsystem to use when the processor runs in 
370-XA mode. A logical control unit is a logical representation of one to four 
physical control units. IOCP builds a logical control unit for: 


¢ Each control unit with no devices or no devices shared with other control units. 
¢ Each group of two to four control units that share devices between them. 


The channel subsystem uses the logical control units for queuing I/O requests for the 
devices attached to the associated physical control units. There is one I/O request 
queue for each logical control unit. The channel subsystem queues all I/O requests 
for all devices in the logical control unit (all the devices attached to the set of 
physical control units in the logical control unit) to the same I/O request queue. 


IOCP also establishes a rotation order for the channel paths associated with each 
logical control unit. When initiating I/O requests queued to the logical control unit, 
the channel subsystem uses this rotation order to determine the sequence for 
selecting channel paths. The section “Rotation Algorithm” in Chapter | describes 
how IOCP establishes the rotation order of the channel paths. 


The CNTLUNIT macro instruction must follow any CHPID macro instructions that 
specify channel paths used by the control unit. The CNTLUNIT macro instruction 


must precede any IODEVICE macro instructions that refer to the control unit. 


The format of the CNTLUNIT macro instruction is: 


[symbol] CNTLUNIT CUNUMBR = number 
PATH = (chpid[,chpid]...) 
[PROTOCL = {D|S|S4}] 


SHARED = {Y|/YB|N} 
UNIT = type 
UNITADD = ((address[,number ]),...) 


CUNUMBR = number 
specifies the hexadecimal number assigned to the control unit. You specify three 
hexadecimal digits in the range of 000 through FFF. You must assign each 
control unit a unique number. You can arbitrarily assign the numbers. 
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PATH = chpid 


specifies the channel path(s) attached to the control unit. You specify one to 
four channel path identifiers for the control unit. You must specify two 
hexadecimal] digits for each channel path identifier. 


Note: If you specify the control unit as shared (SHARED = Y) or shared block 
(SHARED = YB), then you cannot specify channel paths that operate in byte 
multiplexer mode for the control unit. 


For a system on which you generate VM/SP or VM/SP HPO: The PATH 
parameter corresponds to information found on the ADDRESS parameter of the 
RCTLUNIT macro instruction in the DMKRIO file. 


The leftmost digit of the ADDRESS parameter of the RCTLUNIT macro 
instruction is the channel address of the control unit. When you code the 
CHPID macro instruction, you use the channel address for the channel number. 


Find the channel path identifier that you coded with the channel number on the 
CHPID macro instruction. Code this value for the PATH parameter. 


For example, the following RCTLUNIT macro instruction resides in DMKRIO: 


RCTLUNIT ADDRESS=4A0,... 


The channel address is 4. The CHPID coded for channel address 4 could be: 


CHPID PATH=((12,4,0)),... 


a ed 


The channel path identifier you need for the PATH parameter on the 
CNTLUNIT macro instruction is 12. 


CNTLUNIT ...,PATH=12,... 


PROTOCL= 


specifies the interface protocol that the control unit uses when operating with the 
channel paths specified on the PATH parameter. 


D 
specifies the D. C. interlock protocol. This protocol is the standard I/O 
interface that requires the demand response. D is the default if you do not 
code PROTOCL. 

S 


specifies the data streaming protocol at a data rate of up to 3.0 megabytes. 
This protocol does not require the demand response but continues at the 
rate governed by the control unit. S is valid only for a control unit that is 
attached to block-multiplexer channel paths. 
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S4 
specifies the data streaming protocol at a data rate of up to 4.5 megabytes. 
This protocol does not require the demand response but continues at the 
rate governed by the control unit. S4 is valid only for a control unit that is 
attached to block-multiplexer channel paths. 


Note: You may specify S4 if your processor has been upgraded to support 
a data rate of 4.5 megabytes. To operate at 4.5 megabytes on a Model X 
processor, no more than two channel paths per DSE can attach to control 
units that have PROTOCL=S4. To operate at 4.5 megabytes on a 
processor that is not a Model X, the control unit can only be attached to 
channel paths with the following identifiers: 06, 07, 16, 17, 26, 27, 46, 47, 
56, 57, 66, and 67. 


Note: Incorrect specification of the PROTOCL parameter may produce 
unpredictable results. For example, if you specified S or S4 (data streaming) for 
a control unit that supports the D.C. interlock protocol, I/O requests can result 
in either detected errors (such as data overruns or interface control checks) or 
undetected errors. 


SHARED = 
specifies the level of concurrency of I/O requests that the channel allows for the 
control unit. In 370 mode, the parameter specifies how to assign subchannels. 
In 370-XA mode, IOCP sets the control unit type (1 or 2) automatically based 
on the SHARED parameter that you specify. See Appendix D for more 
information on specifying the SHARED parameter. (For further information on 
control unit types, see the topic “Logical Control Units” in Chapter 1.) 


Y 
specifies that the control unit (such as the 3803 for magnetic tape units) has 
one or both of the following attributes: 


¢ The control unit supports only one I/O request at a time, regardless of 
the number of I/O devices attached. 


¢ The control unit clears pending sense information in the control unit for 
an I/O device if the channel initiates an I/O request for another attached 
I/O device. 


For 370 mode, assigned to all the devices attached to the control unit is a 
single shared subchannel (for each attaching channel path) and the channel 
operates in selector mode. 


For 370-XA mode, you assign the control unit as type | and each device as 
a subchannel. 


In both modes, the channel ensures processing of only one I/O request at a 
time for all devices sharing the control unit. For 370-XA mode, if sense 
information is pending in the control unit for an I/O device attached to the 
control unit, the channel ensures that I/O requests for other I/O devices 
attached to the control unit are not initiated until the system control 
program has issued an I/O request to clear the pending sense information. 


You cannot specify SHARED =Y for control units that attach to a byte 
multiplexer channel path. 


Chapter 3. Executing the VM Version of IOCP 3-13 


YB 
specifies that the control unit (such as the 3258, 3272, or 3274) has one or 
both of the attributes of SHARED=Y, but supports disconnect command 
chaining (DCC) operations. 


For 370 mode, assigned to all the devices attached to the control unit is a 
single shared subchannel (for each attaching channel path) and the channel 
operates in block multiplexer mode. 


For 370-XA mode, you assign the control unit as type 1 and each device as 
a subchannel. 


In both modes, the channel ensures processing of only one I/O request at a 
time for all devices sharing the control unit. For 370-XA mode, if sense 
information is pending in the control unit for an I/O device attached to the 
control unit, the channel ensures that I/O requests for other I/O devices 
attached to the control unit are not initiated until the system control 
program has issued an I/O request to clear the pending sense information. 


You cannot specify SHARED = YB for control units that attach to a byte 
multiplexer channel path. 


specifies that the control unit supports multiple I/O requests concurrently 
(one for each attached I/O device). 


Each I/O device attached to the control unit is assigned a separate 
subchannel. For 370-XA mode, the control unit is assigned as type 2. 


The channel accepts and initiates one I/O request for each I/O device and 
operates in either block or byte multiplexer mode, depending on how you 
specify the attaching channel path. 


UNIT = type 
specifies the type of control unit. You specify up to five alphanumeric 
characters that identify the type of control unit. JOCP only checks the syntax 
for alphanumeric characters. IOCP does not validate the type value. 


You must specify a type for every control unit in your I/O configuration. You 
specify a type on the UNIT parameter in one of two ways: 


¢ For devices that do not have a separately assigned control unit type (for 
example, when the control unit function is built into the same physical unit 
as the device), you can specify the device type on the UNIT parameter. For 
example, for the 3800 Printing Subsystem you can specify UNIT = 3800 on 
the UNIT parameter of the CNTLUNIT macro instruction (as well as 
UNIT = 3800 on the IODEVICE macro instruction) 


e For devices that do have a separately assigned control unit type, you must 
specify the specific control unit type on the UNIT parameter (such as 
UNIT = 3803) 


For a system on which you generate VM/SP or VM/SP HPO: The UNIT 
parameter is the same as the CUTYPE parameter on the RCTLUNIT macro 
instruction in the DMKRIO file. For example, the following macro instruction 
appears in the DMKRIO file: 


RCTLUNIT ...,CUTYPE=3811 


3-14 IOCP User’s Guide and Reference 


The corresponding IOCP macro instruction is: 


CNTLUNIT ...,UNIT=3811,... 


UNITADD = 


address 
specifies the unit addresses of the I/O devices that the control unit 
recognizes. You specify two hexadecimal digits in the range of 00 through 
FF. You must specify at least one unit address. A unit address need not 
represent an attached device. (For example, UNITADD = ((0A),(0B),(OF)) 
specifies that the control unit recognizes unit addresses 0A, OB, and OF.) 


number 
specifies the number of sequential unit addresses recognized by the contro] 
unit. You specify a one-, two-, or three-digit decimal value in the range of 1 
through 256. (For example, UNITADD = ((0A,3)) specifies that the control 
unit recognizes unit addresses 0A, 0B, and 0C.) The unit address plus the 
number of addresses must not exceed a hexadecimal address of FF. If 
number is omitted, a value of | is assumed. 


You can specify a maximum of eight addresses and/or sets of address and 
number values. If you do not specify the UNITADD parameter on the 
IODEVICE macro instruction, the unit addresses specified must include the unit 
addresses (the second and third digits) specified on the ADDRESS parameter of 
the IODEVICE macro instruction for the attached devices.If you specify the 
UNITADD parameter on the IODEVICE macro instruction, the unit addresses 
specified must include the unit addresses specified on the UNITADD parameter 
for the attached devices. 


Note: See Appendix D for the exceptions and recommendations that apply to 
specific device types. 


You must specify the full range of unit addresses that the control unit can 
address whether the devices are attached or not. 


For a system on which you generate VM/SP or VM/SP HPO: The UNITADD 
parameter corresponds to information found on the ADDRESS parameter and 
the FEATURE parameter of the RCTLUNIT macro instruction in the 
DMKRIO file. The address portion of UNITADD is the same number as the 
two rightmost digits of the ADDRESS parameter on the RCTLUNIT macro 
instruction. The number portion of UNITADD is the same as the FEATURE 
number. 


For example, the RCTLUNIT macro instruction is: 


RCTLUNIT ADDRESS=4A0,...,FEATURE=16-DEVICE 
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The corresponding CNTLUNIT macro instruction is: 


CNTLUNIT ...,UNITADD=((AO,16)) 


For the RCTLUNIT macro instruction, the default FEATURE number is 8. 
Always code 8 as the number portion of UNITADD = if you do not explicitly 
code the FEATURE parameter on the RCTLUNIT macro instruction. _ 


Example: The following macro instruction assigns the control unit number of 10A 
to an IBM 2821 Control Unit, names channel path 06 as the channel path to which 
the control unit attaches, and defines unit addresses 0A through OC as recognized by 
the control unit. D is the default for PROTOCL. 


CU10A | CNTLUNIT | CUNUMBR=10A,PATH =06,SHARED=N, 
UNIT = 2821, UNITADD = ((0A,3)) - 


Example: The following macro instruction assigns the control unit number of 00E 
to a 3803 Tape Control, names channel path 05 as the channel path to which the 
control unit attaches, specifies the D. C. interlock protocol, and defines unit . 
addresses 80 through 8F as recognized by the control unit. 


CU00E | CNTLUNIT CUNUMBR = 00E,PATH =05,PROTOCL =D, 
; | SHARED = Y,UNIT = 3803, UNITADD = ((80, 16)) 


Example: The following macro instruction assigns the control unit number 11A to a 
control unit that the customer has named DUMMY, names two channel paths 06 
and 07 as the channel paths to which the control unit attaches, and defines unit 
addresses 90 through 9F and AO through AF as recognized. by the control unit. 


CUIIA | CNTLUNIT | CUNUMBR=11A,PATH = (06,07),PROTOCL =D, 


SHARED = Y,UNIT = DUMMY, 
UNITADD = ((90,16),(A0,16)) 


Example: The following macro instruction assigns the control unit number of 031 
to an IBM 3272 Control Unit, names channel path 04 as the channel path to which 
the control unit attaches, and defines unit addresses DO through DF as recognized 
by the control unit. . | ? 


CNTLUNIT CUNUMBR = 031,PATH =04,PROTOCL =D, 


SHARED = YB, UNIT = 3272, 
UNITADD = ((D0,16)) 
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ID 


-ID is an optional macro instruction that describes the identification information 


printed on the IDI and ID2 lines of the IJOCP configuration report headings. It is 
also the source of the customer name (data set name) for the IOCDS that appears 
on the IOCDSM (SYS021) frame. 


See “Chapter 5. IOCP Configuration Reports” for examples of the headings used on 
the reports. 


When specified, the ID macro instruction must precede all CHPID, CNTLUNIT, 
and IODEVICE macro instructions in the input file. You can specify the ID macro 
instruction only once in the input file. If you do not specify the ID macro 
instruction, IOCP prints no identifying information on the ID1 and ID2 lines of the 
heading. 


The format of the ID macro instruction is: 


[symbol] | ID MSG1 = ‘message’,M SG2 = message’ 


MSGI = ‘message’ 
MSG2 = ‘message’ 


MSG1 = 

specifies the identification information printed on the ID1 line of the heading on 

- IOCP configuration reports. The processor controller also uses the first eight 
characters of MSG1= (bytes 1 through 8) as the customer name for the IOCDS 
that appears on the LOCDSM (SYS021) frame. (For more information, see the 
operator’s guide for your system console.) 


MSG2= 
specifies the identification information printed on the ID2 line of the heading on 
IOCP configuration reports. 


‘message’ . 
specifies a string of 1 to 64 alphanumeric characters for use as identification 
information. You must enclose the string within apostrophes. Two consecutive 
apostrophes count as one character indicating an apostrophe within the string 
(such as, MSG1 = ‘John’'s I/O Report’). 


Example: The following macro instruction defines the identification information 


printed on lines ID1 and [D2 of the IOCP configuration report headings. 


TPCONFIG is the customer name for the IOCDS that appears on the IOCDSM 
(SYS021) frame. 


MSG1 =’TPCONFIG Configuration for Processor B’, X 


MSG2=’Revised by Plan 3’ 
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IODEVICE 


IODEVICE, a required macro instruction, describes: 


¢ The I/O device address/number 
¢ The device characteristics 
¢ The control units to which the device is assigned 


You must specify each uniquely addressable I/O device in your I/O configuration on 
an IODEVICE macro instruction to use the device for I/O requests. 


See Appendix D for a list of I/O device types and their characteristics. 


Note: VM/SP, VM/SP HPO, or the VM/XA Systems Facility does not necessarily 
support devices supported by IOCP. For a list of the devices supported by VM/SP, 
see the latest edition of JBM Virtual Machine/System Product General Information 
Manual; for VM/SP HPO, see the JBM VM/SP High Performance Option General 
Information Manual. For a list of devices supported by the VM/XA Systems 
Facility, see the Virtual Machine/Extended Architecture Systems Facility: General 
Information Manual. 


You can assign up to 256 devices to one channel path. You assign one device to a 
maximum of four control units. Although you can attach a control unit to a 
maximum of four channel paths, you can assign a device only to a combined 
maximum of four channel paths. 


Each I/O device must have a unique device address/number within the I/O 
configuration. IOCP does not allow duplicate addresses. 


To assign an I/O device to both channel set 0 and channel set 1 (for 370 mode 
channel sets), specify the device address/number on an IODEVICE macro instruction 
and the device’s unit address on the CNTLUNIT macro instruction(s) that define(s) 
the control unit(s) attached to channel paths in both channel sets. (On a 
uniprocessor, VM/SP and VM/SP HPO can access only channel set 0; therefore, you 
must assign all I/O devices you want to use to channel set 0.) 


The IODEVICE macro instruction must follow any CNTLUNIT macro instructions 
that specify control units used by the device. 


The format of the IODEVICE macro instruction is: 


[symbol] | IODEVICE ADDRESS = (address[,number ]) 
CUNUMBR = (number[,number]...) 
[MODEL = model} 


[PATH =chpid] 
[TIMEOUT = {Y|N}] 
UNIT = device 
[UNITADD = address] 


ADDRESS = 


address 
specifies the device address in 370 mode and the device number in 370-XA 
mode. You specify three hexadecimal digits in the range of 000 through 
FFF. 
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For 370 mode operation, the first hexadecimal digit (0-F) must specify the 
channel number that corresponds to the lowest-numbered channel path 
assigned to the device. This channel path is the primary channel address for 
the device. 


In 370-XA mode, the first hexadecimal digit does not have to correspond to 
the 370 channel number. If you want to use the same IOCDS to operate in 
both 370 mode and 370-XA mode, specify the first hexadecimal digit for 
370-XA mode the same way you do for 370 mode. In all cases, specify a 
hexadecimal digit in the range of 0 through F. 


If you do not specify the UNITADD parameter on the IODEVICE macro 
instruction, the second and third hexadecimal digits of the ADDRESS 
parameter specify the physical unit address that is transmitted on the 
channel path to select the device. You specify two hexadecimal digits in the 
range of 00 through FF. These two hexadecimal digits must match one of 
the unit addresses specified on the UNITADD parameter of the 
CNTLUNIT macro instruction that defines the control units assigned to the 
device. 


If you do specify the UNITADD parameter on the IODEVICE macro 
instruction, the second and third digits of the ADDRESS parameter can be 
any value that follows the rules in Appendix D and makes the device 
address/number unique. See Appendix D for the exceptions and 
recommendations that apply to specific device types. 


number 
specifies the number of sequential device addresses/numbers assigned to the 
devices. You specify a one, two, or three-digit decimal value in the range of 
1 through 256. (For example, ADDRESS = (10A,3) specifies that the device 
addresses of 10A, 10B, and 10C are assigned.) 


If you do not use the UNITADD parameter on the IODEVICE macro 
instruction, the unit address (second and third digits) specified on the 
ADDRESS parameter plus the number of addresses minus one must not 
exceed a hexadecimal value of FF. 


If you do use the UNITADD parameter, the device address/number 
specified on the ADDRESS parameter plus the number of addresses minus 
one must not exceed a hexadecimal value of FFF. 


If you omit number (when using file input) and you specify NOIGNORE on 
the IOCP command, IOCP assumes a default value of 1. If you specify 
IGNORE, IOCP assumes a default value of 1 except for some devices, as 
noted in Appendix D. 


For example, if you use file input and specify IGNORE, IOCP checks the 
syntax of the number subparameter for the 2305 Fixed Head Storage and 
the 3838 Array Processor, but IOCP unconditionally assigns eight addresses 
to these devices. 


Each device address specified must be unique within the I/O configuration. 
IOCP does not allow duplicate addresses. 


Note: See Appendix D for the exceptions and recommendations that apply to 
specific device types. 
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For a system on which you generate VM/SP or VM/SP HPO: The 

ADDRESS = (address“,number”) parameter on the IODEVICE macro 
instruction in the IOCP input file has the same value as the 

ADDRESS = cuu|(cuu,nn) parameter on the RDEVICE macro instruction in the 
DMKRIO file. 


For example, this RDEVICE macro instruction is in the DMKRIO file: 


RDEVICE ADDRESS=(018,7),... 


The corresponding IODEVICE macro instruction is: 


IODEVICE ADDRESS=(018,7),... 


For a system on which you generate the VM/XA Systems Facility: The 
ADDRESS = (address[,number]) parameter on the IODEVICE macro 
instruction in the IOCP input file has the same value as the 

DEVNO = rdevno|(rdevno,nnn) parameter on the RDEVICE macro instruction 
in the HCPRIO file. 


For example, this RDEVICE macro instruction is in the HCPRIO file: 


RDEVICE DEVNO=(190,4),... 


The corresponding IODEVICE macro instruction is: 


IODEVICE ADDRESS=(190,4),... 


CUNUMBR = number 


specifies the control unit numbers assigned to the control units attached to the 
device. You specify three hexadecimal digits in the range of 000 through FFF 
for each control unit. 


You can assign a device to a maximum of four control units. Although you can 
attach each control unit to a maximum of four channel paths, you can assign a 
device only to a combined maximum of four channel paths. 


When you attach the device to more than one control unit (for example, via a 
string switch), you must specify each control unit. 


IOCP User’s Guide and Reference 


If you attach a device to more than one control unit, all control units that attach 
to the device must: 


Use the same unit address to access the device. 

Have the same SHARED characteristic (Y, YB, or N). 
Have the same interface protocol (D, S, or S4). 

Not be attached to the same channel path. 


For a system on which you generate VM/SP or VM/SP HPO: To code the 
control unit number, you must make a number of cross-references between the 
IODEVICE macro instruction and the RDEVICE macro instruction in the 
DMKRIO file. 


Find the RDEVICE macro instruction for this device in the DMKRIO file. The 
leftmost digit on the ADDRESS =cuu parameter of this macro instruction is the 
channel address to which the device attaches. The two rightmost digits represent 
the unit address transmitted on the channel path to select the device. 


Find the CHPID macro instruction coded for the channel address found in the 
RDEVICE macro instruction. Use the channel path identifier from this CHPID 
macro instruction and the unit address from the RDEVICE macro instruction 
for the next cross-reference. 


Find the CNTLUNIT macro instruction that has (1) a channel path that 
matches your channel path identifier and (2) a unit address that matches the unit 
address on the RDEVICE macro instruction. Use the value coded for the 
CUNUMBR parameter on the CNTLUNIT macro instruction for the control 
unit number on the IODEVICE macro instruction. 


For example, the RDEVICE macro instruction for a 3330 magnetic disk could 
be: 


RDEVICE ADDRESS=(350,8) ,DEVTYPE=3330,... 


The channel address to which this device attaches is 3. The CHPID macro 
instruction coded for this channel address is: 


CHPID PATH=((03,3,0)),... 


The channel path identifier is 03 in this case. In the above RDEVICE macro 
instruction, the unit address is 50. The CNTLUNIT macro instruction with a 
channel path 03 and unit address 50 is: 


CNTLUNIT CUNUMBR=032 , PATH=(03),...,UNITADD=( (50,8) ) 
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The CUNUMBR parameter on the IODEVICE macro instruction should be 
032: 


IODEVICE ADDRESS=(350,8) , CUNUMBR=032, ... ,UNIT=3330 


For a system on which you generate the VM/XA Systems Facility: To code the 
control unit number for a device, you must find the correct CNTLUNIT macro 
instruction. 


When you generate an operating system that supports extended architecture, the | 
device number for a given device does not need to correspond to either a 
channel path identifier or the unit address by which the control unit recognizes 
the device. You must know the following about your hardware I/O 
configuration: 


e What channel path identifier the device and its control unit are attached to. 
¢ How the control unit recognizes the device, that is, by what unit address. 


Find the CNTLUNIT macro instructions that has (1) a channel path that 
matches your channel path identifier to which the device and control unit are 
attached and (2) a unit address that matches the unit address by which the 
control unit recognizes the device. Use the value coded for the CUNUMBR 
parameter on the CNTLUNIT macro instruction for the control unit number on 
the IODEVICE macro instruction. 


For example, eight 3330 magnetic disks and their control unit are attached to 
channel path identifier 07. The control unit recognizes the disks as attached at 
unit addresses 40 through 47. 


However, the RDEVICE macro instruction for this group of magnetic disks 
could be: 


o_O 


RDEVICE DEVNO=(350,8) ,DEVTYPE=3330,.... 


The device numbers for these disks range from 350 to 357. 


The CHPID macro instruction coded for the channel path identifier is: 


CHPID PATH=((07,6,0)),.... 


The channel path identifier is 07; it corresponds to channel 6 and to channel set 
0 when the processor complex operates in 370 mode. 
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The physical unit addresses of these devices are 40 through 47. The 
CNTLUNIT macro instruction that has channel path 07 and unit addresses 
ranging from 40 to 47 is: 


CNTLUNIT CUNUMBR=032, PATH=(07),....,UNITADD=((40,8)) 


The CUNUMBR parameter on the I[ODEVICE macro instruction should be 
032: 


IODEVICE ADDRESS=(350,8) , CUNUMBR=032,....,UNIT=3330,UNITADD=40 


(The UNITADD parameter on the IODEVICE macro instruction has the same 
same number of unit addresses (8) as the number specified in the ADDRESS 
parameter. ) 


Note: This example uses the UNITADD parameter that allows you to define 
device numbers (350 to 357) that do not contain their physical unit addresses (40 
to 47). If you operate the processor complex in 370 mode with this IOCDS, the 
processor complex would recognize the devices as 640 to 647 (channel 6, physical 
unit addresses 40 to 47). 


We recommend you specify the UNITADD parameter on the IODEVICE macro 
instruction only for an IOCDS that will be used exclusively for 370-XA mode 
operation. If you plan to generate an operating system that only supports 370 
architecture, define your device numbers so that they follow 370 restrictions: 


¢ The leftmost digit corresponds to a channel address. 


¢ The two rightmost digits correspond to the physical unit address by which 
the control unit recognizes the device. 


For more information, see the description of the UNITADD parameter on the 
JODEVICE macro instruction in this chapter. 


MODEL = model 
specifies the model number, if any, for the device. You specify one or two 
alphanumeric characters that represent the model number of the device. IOCP 
only checks the syntax for alphanumeric characters. IOCP does not validate the 
model value. 


For a system on which you generate VM/SP or VM/SP HPO: The 

MODEL = model parameter on the IODEVICE macro instruction in the IOCP 
input file has the same value as the MODEL =model parameter on the 
RDEVICE macro instruction in the DMKRIO file. 
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For example, the following RDEVICE macro instruction is in the DMKRIO 
file: 


RDEVICE ...,MODEL=3 


The corresponding IODEVICE macro instruction is: 


IODEVICE ...,MODEL=3,... 


For a system on which you generate the VM/XA Systems Facility: The 
MODEL = model parameter on the IODEVICE macro instruction in the IOCP 
input file has the same value as the MODEL =model parameter on the 
RDEVICE macro instruction in the HCPRIO file. 


For example, the following RDEVICE macro instruction is in the HCPRIO file: 


RDEVICE ...,MODEL=11 


The corresponding IODEVICE macro instruction is: 


— 


IODEVICE ...,MODEL=11,.. 


PATH= chpid 


specifies the preferred channel path. You specify two hexadecimal digits that 
must correspond to a channel path identifier of an attaching channel path. 


In 370-XA mode, the channel subsystem always attempts to use the preferred 
channel path to initiate I/O requests. The channel subsystem will attempt to 
initiate all I/O requests for the desired device using the specified preferred 
channel path first, before it attempts to initiate requests on any of the other 
attaching channel paths. When operating in 370 mode, the processor complex 
ignores the preferred channel path. See “Preferred Path” in Chapter 1 for more 
information. 
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TIMEOUT = 
specifies whether the eight-second I/O interface timeout function is to be active 
for the I/O interface tag sequences between the channel and I/O device. 


Y 
specifies that the I/O interface timeout function is to be active for all 
sequences on the I/O interface except as noted in Appendix C. With the 
timeout function active, if the I/O device fails to complete a tag sequence 
within eight seconds or a delay occurs in a dependent tag sequence that 
exceeds eight seconds, the channel terminates the I/O request to the I/O 


device and generates an interface-control-check interruption. 


TIMEOUT = Y is the default if you do not code the TIMEOUT parameter. 


specifies that the I/O interface timeout function is inactive (timeout 
inhibited) for some of the sequences on the I/O interface as described in 
Appendix C. With the timeout function inactive, the channel waits until the 
I/O device completes the tag sequence or initiates the next dependent 
sequence. 


TIMEOUT =N is not valid for I/O devices assigned to byte multiplexer 
channel paths. . 


We recommend that you specify or use the default TIMEOUT = Y for all IBM 
I/O devices. However, for certain I/O devices, normal I/O sequences sometimes 
require more than eight seconds to complete. For example, some I/O sequences 
on a channel-to-channel (CTC) adapter might require more than eight seconds 
to complete. For these devices, you may chose to specify TIMEOUT =N. 


See Appendix C for additional information about the timeout function. 


Note: When operating in 370 mode, the TIMEOUT specification for the lowest 
device address on a shared control unit (SHARED = Y or SHARED = YB) 
overrides the timeout specification of the other devices connected to the same 
control unit. For example, device LAO connects toa shared control unit and has 
TIMEOUT=Y; device 1A1 connects to the same control unit and has 
TIMEOUT=N. In 370 mode, both devices are timed. In 370-XA mode, device 
1A0 is timed; device 1A1 is not timed. . 


UNIT = device . 
specifies the device type. You specify up to five alphanumeric characters to 
define the device type (such as, 3330 or 2540R). IOCP only checks the syntax 
for alphanumeric characters. LOCP does not validate the device value. 
However, for certain device types (such as 3350P), IOCP takes special actions. 
See Appendix D for more information. 


For a system on which you generate VM/SP or VM/SP HPO: The 
UNIT = device parameter on the LODEVICE macro instruction in the IOCP 
input file has the same value as the DEVTYPE = type parameter on the 
RDEVICE macro instruction in the DMKRIO file. 


} 
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For example, assume the following RDEVICE macro instruction is in the 
DMKRIO file: 


RDEVICE ...,DEVTYPE=3279,... 


The corresponding IODEVICE macro instruction is: 


IODEVICE ...,UNIT=3279,... 


For a system on which you generate the VM/XA Systems Facility: The 
UNIT = device parameter on the IODEVICE macro instruction in the IOCP 
input file has the same value as the DEVTYPE= type parameter on the 
RDEVICE macro instruction in the HCPRIO file. 


For example, assume the following RDEVICE macro instruction is in the 
HCPRIO file: 


RDEVICE ...,DEVTYPE=2540P,... 


The corresponding IODEVICE macro instruction is: » 


IODEVICE ...,UNIT=2540P,... 


UNITADD = address 


specifies the unit address transmitted on the channel path to select the I/O 
device. You specify two hexadecimal digits in the range of 00 through FF. 
These two hexadecimal digits must match one of the unit addresses specified on 
the UNITADD parameter of the CNTLUNIT macro instruction that defines the 
control units to which the device is assigned. 


UNITADD allows you to assign a device number in the ADDRESS parameter 
that does not contain the actual physical unit address of the device; this might 
be necessary because channel numbers may only have one hexadecimal digit and 
device numbers must be unique. The UNITADD parameter that you specify 
becomes the unit address that the control unit recognizes for the device in both 
370 mode and 370-XA mode. 
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Specify the UNITADD parameter only for an IOCDS that will be used 
exclusively for 370-XA mode operation. Operational and serviceability problems 
are likely to occur if you use the IOCDS (defined with UNITADD) in 370 
mode. 


If you specified a value for number in the ADDRESS parameter, that same 
number of sequential device numbers applies to the UNITADD parameter. 

However, the UNITADD parameter plus the number of device numbers (or 
device addresses) must not exceed a hexadecimal value of FF. 


Notes: 


1. If you use the UNITADD parameter, you must follow the same rules and 
restrictions that apply to the second and third digits of the ADDRESS 
parameter. For example, notes in Appendix D that apply to the unit 
address specified on the ADDRESS keyword also apply to the unit address 
specified on the UNITADD parameter. 


2. If you specify the UNITADD parameter and use the IOCDS for 370 mode 
operation, the two digits specified in the UNITADD parameter replace the 
two rightmost digits of the device address. UNITADD changes the device 
address and makes it different from the device number. For example, 
ADDRESS = 180, UNITADD = 90 produces a device address (370 mode) of 
190 (if the device connects to a channel path defined for 370 mode as 
channel 1). However, the device number (370-XA mode) is still 180. Thus, 
messages and error records for the same device will be issued using different 
device identifiers, 190 in 370 mode and 180 in 370-XA mode. It is also 
possibie that messages and error records for a device identifier (a device 
address or device number) could actually represent more than one device. 


For a system on which you generate VM/SP or VM/SP HPO: We recommend that 
you specify the UNITADD parameter only for an IOCDS that you use exclusively 
for 370-XA mode operation. If you operate the processor complex in 370 mode and 
the active IOCDS has devices defined with the UNITADD parameter, operational 
and serviceability problems are likely to occur. 


For a system on which you generate the VM/XA Systems Facility: To code the 
UNITADD parameter, you must know how the control unit recognizes the device, 
that is by what unit address. You must code the actual physical unit address for the 
UNITADD parameter on the IODEVICE macro instruction. 


For example, the RDEVICE macro instruction for a group of eight 3330 magnetic 
disks could be: 


RDEVICE DEVNO=(350,8) ,DEVTYPE=3330,.... 


The device numbers for these disks range from 350 to 357. The control unit, 
however, recognizes the disks as being attached at unit addresses 40 through 47. 
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ff 


The UNITADD parameter on the IODEVICE macro instruction should be 40: 


IODEVICE ADDRESS=(350,8),....UNIT=3330,UNITADD=40 


(The UNITADD parameter on the IODEVICE macro instruction takes the same 


number (8) as specified in the ADDRESS parameter.) 


Note: This example uses the UNITADD parameter to define device numbers (350 
to 357) that do not contain their physical unit addresses (40 to 47). If you were to 
operate the processor complex in 370 mode with this IOCDS, the processor complex 
would recognize the devices as 340 to 347 (channel 3, physical unit address 40 to 47). 


We recommend, however, that if you specify the UNITADD parameter on an 


* IODEVICE macro instruction, you operate the processor complex with that IOCDS 


only in 370-XA mode. If you plan to generate an operating system that only 
supports 370 architecture, define your device numbers so that they follow 370 
restrictions: 


e The leftmost digit corresponds to a channel address. 
e The two rightmost digits correspond to the unit address by which the control 


unit recognizes the device. 


Example: The following macro instruction defines a 2540 Card Read Punch Model 
1 with an address of OOD. It attaches to a 2821 Control Unit that has a control unit 
number of 10A. 


DEVO00D | IODEVICE | ADDRESS =00D,CUNUMBR= 10A,MODEL = 1, 
UNIT =2540P, TIMEOUT = Y 


Example: The following macro instruction defines eight 3330 Disk Storage Model | 
devices. The 3830 Storage Control has a control unit number 11B and recognizes 
the device addresses/numbers of 210 through 217. 


DEV2DD | IODEVICE | ADDRESS =(210,8),CUNUMBR = 11B, 
MODEL = 1, UNIT = 3330, TIMEOUT= Y 


Example: The following macro instruction defines eight 3420 Magnetic Tape Units. 
The 3803 Tape Control has the control unit number 00E and recognizes the device 
addresses/numbers of D80 through D87. 


| DEVDTT 


IODEVICE | ADDRESS =(D80,8),CUNUMBR =00E, 
MODEL = 3,UNIT = 3420, TIMEOUT = Y 
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Example: The following macro instruction defines eight 3420 Magnetic Tape Units 
attached to two 3803 Tape Controls via the tape switching feature. The control 
units are assigned the numbers 01B and 01C. Both control units recognize the unit 
addresses of 40 through 47. (Note: In this case the control units must attach to 
different channel paths to ensure that unit addresses are not duplicated on the same 
channel path.) C is the channel number that corresponds to the lower numbered 
channel path assigned to the device. 


DEVTUU| IODEVICE | ADDRESS=(C40,8),CUNUMBR = (01B,010), 
MODEL = 3,UNIT = 3420, TIMEOUT = Y 


Example: The following macro instruction defines two 3350 I/O devices for use as 
paging devices by the 3880 Model 11 Paging Storage Subsystem. The 3880 Model 
11 Paging Storage Director has been assigned control unit number 14B. 


IOCP generates four device addresses/numbers for each 3350P (a 3350 used as a 
paging device by the 3880 Model 11): the base address as specified on the 
ADDRESS parameter, and three additional addresses at intervals of eight. 


This macro instruction causes IOCP to generate addresses 440, 448, 450, and 458 for 
base address 440, and addresses 441, 449, 451, and 459 for base address 441. 


DEV4DD |; IODEVICE | ADDRESS = (440,2),CUNUMBR = 14B, 
UNIT = 3350P, TIMEOUT = Y 


Example: The following macro instruction defines eight 3420 Magnetic Tape Units. 
The 3803 Tape Control has been assigned the control unit number 530. The device 
numbers (for 370-XA mode) are 180 through 187. But the devices respond to the 
unit addresses of 90 through 97 (not 80 through 87) in both 370-XA mode and 370 
mode. Thus, the device addresses (for 370 mode) are actually 190 through 197. 


DEVIUA | IODEVICE |; ADDRESS =(180,8),CUNUMBR = 530, 
. MODEL =3,UNIT = 3420, UNITADD = 90 
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IOCP Functions 


You invoke the VM version of IOCP in the CMS environment. Issue the CMS 
IOCP command to execute IOCP under VM/SP, VM/SP HPO or the VM/XA 
Systems Facility. The IOCP command has options that allow you to request the 
following IOCP functions: 


Generate a new IOCDS from a file containing source IOCP macro instructions 
Produce configuration reports from an existing IOCDS.! 


Generating an lIOCDS 
IOCP performs the following steps when you specify that you want to generate an 
IOCDS. 


Note: IOCP repeats steps 1 through 5 for each input macro instruction read (unless 
IOCP finds an error as indicated in Steps 3 and 4). 


IOCP: 


1. 
2 
3: 


Reads each macro instruction from the input device. 
Prints each macro instruction on the output printer. 


Checks the syntax of each macro instruction for correct format. If it finds a 
syntax error (such as a missing parenthesis), IOCP prints an error message on 
the output printer following the macro instruction that contains the error. IOCP 
stops checking the syntax of a macro instruction when it encounters the first 
syntax error on that macro instruction. Therefore, if there are two or more 
syntax errors on a single macro instruction, IOCP finds the second and following 
errors on subsequent runs. 


If IOCP finds an error in Step 3, IOCP returns to Step | and continues reading, 
printing, and checking the syntax of the remaining macro instructions, but does 
not perform any of the following steps. 


. Checks the validity of each macro instruction. For example, IOCP checks that a 


CNTLUNIT macro instruction has specified a channel path previously defined 
on a CHPID macro instruction. If it finds an error, [OCP prints an error 
message on the output printer following the macro instruction that contains the 
error. 


If IOCP finds an error in Step 4, IOCP returns to Step | and performs only 
Steps 1 through 3 for the remainder of the macro instructions. Therefore, if 
there are two or more validity errors in your input file, IOCP finds the second 
and following errors on subsequent runs. 


. Builds the appropriate identification, channel path, control unit, or I/O device 


record and enters the record into the IOCDS in storage. 


If more macro instructions remain to be read, IOCP returns to Step 1. 


1 The CMS IOCP module DMSICP generates DIAGNOSE X‘80’ when you use the IOCP command to read from or 
to. write to an IOCDS. The Control Program (CP) uses DIAGNOSE X‘80’ to communicate with the processor 
controller. For a description of DIAGNOSE X‘80’, see VM/SP System Programmer’s Guide, VM/SP HPO System 
Programmer's Guide, or VM/XA Systems Facility CP Programming Services. 
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After processing all of the input macro instructions and entering all of the records 
into the IOCDS in storage, [OCP performs Step 6. 


6. Generates the IOCDS in storage and makes additional checks. For example, 
IOCP checks that the channel numbers within a channel set are consecutive. If 
IOCP finds an error, [OCP issues an error message and then terminates. 


After IOCP has successfully generated an IOCDS in storage, IOCP performs Step 7. 
7. Produces the IOCP configuration reports of the IOCDS generated in storage. 


If you specify a generation option of the IOCP command other than NOWRTCDS 
and you are authorized to do so, IOCP performs Step 8. 


8. Writes the generated IOCDS from storage to one or more IOCDS(s) in the 
processor controller. The Control Program (CP) checks your privilege class. If 
you are running IOCP under the VM/SP or VM/SP HPO, you must have 
privilege class C to write to the IOCDS in the processor controller. If you are 
running IOCP under the VM/XA Systems Facility, you must have privilege 
classes C, F, and G to write to the IOCDS in the processor controller. 


Producing Configuration Reports 
IOCP performs the following steps when you request configuration reports. 


IOCP: 


-¢ Reads one or more IOCDS(s) from the processor controller into storage. 
¢ Prints the IOCP configuration reports that you specify. 


If IOCP encounters any errors during processing, [OCP sends appropriate error 
messages to the output printer. For examples of IOCP configuration reports, see 
“Chapter 5. IOCP Configuration Reports”. 
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The lOCP Command 


The format of the IOCP command is: 


where: 


[fn] [(options . . . [)]] 
Processor Options: 


308X 
XXXX 


IOCDS Generation options: 


NOTGNORE |) NOWRTCDS 
IGNORE WRTCDS 
| | WRTAX 
WRTBx 
WRTABx 


Configuration Report options: 


a 
BOTHRPT | 
CDORPT 
CD1IRPT 
RPTAx 
RPTBx 
RPTA 
RPTB 
[RPTAB | 


Listing Control options: 
ear (55) | mn | 


LINECOUN (nn) | | PRINT 
NOPRINT 


System Terminal options: 


| TERMINAL ros 


| NOTERM NOWARN 


fn is the filename of the input or output file, depending on options you specify on 
the command line. . . 


You must specify a filename only when input is from disk or output is to disk. 


When you specify IOCDS generation options, fn is: 


¢ The filename of the input file. The input file contains the IOCP macro 


instructions. 


The filename of the output file. If IOCP finds no errors, the output file will 
contain the configuration reports of the IOCDS IOCP generate from your 
input as well as a listing of your input. If IOCP does find errors, the output 
file will contain only a listing of the input file and any errors that IOCP 
finds. 
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When you specify configuration report options, fn is: 


¢ The filename of the output file. The output file will contain the 
configuration reports of the IOCDS(s) you request from the processor 
controller. 


IOCP issues, by default, the following CMS FILEDEF commands for the 
SYSIN (input to IOCP) and SYSPRINT (output from JOCP) ddnames: 


FILEDEF SYSIN DISK fn IOCP * (RECFM FB LRECL 80 
BLOCK 800 


FILEDEF SYSPRINT DISK fn LISTING fm (RECFM FBA 
LRECL 133 BLOCK 1330 


IOCP obtains fn from the filename entered on the IOCP command. 


IOCP obtains fm by checking the disk that contains the input file. If the disk is 
read/write, IOCP writes back to the same disk. However, if the disk is an 
extension to a disk, IOCP writes to the parent disk. If neither of these is true, 
IOCP writes to the A-disk (provided it is read/write). 


Because the default FILEDEF commands specify DISK, you must use a 
filename on the IOCP command unless you override those default FILEDEF 
commands. If you want to override a default FILEDEF command, issue your 
own FILEDEF command before executing IOCP. . Note that if you specify 
PRINT or NOPRINT on the IOCP command, you will automatically override 
SYSPRINT FILEDEF. 


The input filetype is, by default, IOCP. If you want the the input file to have a 
filetype other than IOCP, issue a FILEDEF command to override the default 
filetype. 


The output filetype is, by default, LISTING. If you want the the output file to 
have a filetype other than LISTING, issue a FILEDEF command to override 
the default filetype. | 


Options: 


IOCDS Generation Options: 


The valid options for writing an IOCDS depend on the number of I/O configuration 
data sets that your processor complex supports: 


For two I/O configuration data sets (LVLO and LVL1), the valid options are 
NOWRTCDS, WRTCDS, and WRTAI. (WRTAL is the same as WRTCDS.) 


For four I/O configuration data sets, the valid options on the A side are 
NOWRTCDS, WRTCDS, and WRTAx. The valid options on the B side are 
NOWRTCDS, WRTCDS, and WRTBx. 


For eight I/O configuration data sets, all of the options are valid. 


IOCP writes an IOCDS to the processor controller (in response to all the generation 
options except NOWRTCDS) only if: 


It finds no errors on the input macro instructions . 

It encounters no errors during IOCP processing of the IOCDS in storage 
The user issuing the IOCP command has the proper privilege class 

You did not write-protect the IOCDS (on the IOCDSM frame) 
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Use a write option (WRTCDS, WRTAx, or WRTBx) after you have (1) checked the 
syntax of the input macro instructions, (2) generated an IOCDS in storage, (3) 
received reports on the generated IOCDS, and (4) checked to see whether or not the 
I/O configuration generated by IOCP corresponds to the I/O configuration in the 
DMKRIO file (for VM/SP or VM/SP HPO) or in the HCPRIO file (for the VM/XA 
Systems Facility). If you want to write to an IOCDS that is write-protected, you 
must also remove the write-protection using the IOCDSM (SYS021) frame. 


When IOCP writes the generated IOCDS to an IOCDS in the processor controller, 
the previous configuration data in that IOCDS is overlaid and lost, even if that 
IOCDS is the active IOCDS. (The IOCDS used for the last power-on reset or 
SYSIML CLEAR is the active IOCDS). 


NOIGNORE 

NOIGN 
specifies that IOCP is to process all input macro instructions and parameters. 
IOCP flags as errors any non-IOCP input data. If IOCP finds an error, it does 
not generate an JOCDS in storage. 


Use the NOIGNORE option when your deck contains only IOCP macro 
instructions and IOCP comment cards. This option is a default. 


IGNORE 

IGN 
specifies that IOCP is to ignore all non-IOCP macro instructions and non-IOCP 
parameters on the IODEVICE macro instruction. 


NOWRTCDS 

NOWRT 
specifies that IOCP is not to write the IOCDS that is in storage to an IOCDS in 
the processor controller. This option is a default. 


Use the NOWRTCDS option when (1) you are checking the syntax of the input 
file and do not want to write to the processor controller until you have 
successfully checked the input file, or (2) when you are operating on a processor 
complex not listed on the cover of this manual. | 


When you specify the NOWRTCDS option and IOCP finds no errors, the 
output file will contain the configuration reports of the IOCDS IOCP will be 
generate from your input along with a listing of your input file. If IOCP finds 
errors, your output file will contain only a listing of your input file and any 
errors that IOCP finds. 


WRTCDS 

WRT 
specifies that IOCP is to write the IOCDS that is in storage to the Al IOCDS 
(LVL1 IOCDS) in the processor controller. 


WRTAx 

WAx . 
specifies that IOCP is to write the IOCDS that is in storage to the level Ax 
(where x is 0, 1, 2 or 3) IOCDS in the processor controller. 


WRTBx 

WBx 
specifies that IOCP is to write the IOCDS that is in storage to the level Bx 
(where x is 0, 1, 2, or 3) IOCDS in the processor controller. (WRTBx is valid 
only on the B side of a processor complex.) 


IOCP User’s Guide and Reference 


WRTABx 

WABx 
specifies that IOCP is to write the IOCDS (where x is 0, 1, 2 or 3) in storage to 
the level x IOCDS in the processor controller on both the A side and the B side. 


This option is only valid if the system is NOT generated in partitioned mode. 
Configuration Report Options 


The valid options for reading an IOCDS and producing configuration reports 
depend on the number of I/O configuration data sets that your processor complex 
supports: 


¢ For two I/O configuration data sets (LVLO and LVLI), the valid options are 
BOTHRPT, CDORPT, CDIRPT, RPTAO, and RPTAI. 


¢ For four I/O configuration data sets, all of the configuration report options are 
valid on the A side except RPTBx and RPTB. On the B side, all of the 
configuration: report options are valid except RPTAx and RPTA. 


¢ For eight I/O configuration data sets, all of the options are valid. 


BOTHRPT 

BOTH 
specifies that IOCP is to read both the AO and Al IOCDS from the processor 
controller into storage and is to generate configuration reports of both data sets. 


CDORPT 

CDO 
specifies that IOCP is to read the AO IOCDS from the processor controller into 
storage and is to generate a configuration report of that data set. 


CDIRPT 

CD1 
specifies that IOCP is to read the Al IOCDS from the processor controller into 
storage and is to generate a configuration report of that data set. 


RPTAx 

RAx 
specifies that IOCP is to read the level Ax (where x is 0, 1, 2, or 3) IOCDS from 
the processor controller into storage and is to generate a configuration report of 
that data set. (RPTAx is valid only on the A side of a processor complex.) 


RPTBx 

RBx 
specifies that IOCP is to read the level Bx (where x is 0, 1, 2, or 3) IOCDS from 
the processor controller into storage and is to generate a configuration report of 
that data set. (RPTBx is valid only on the B side of a processor complex.) 


RPTA 

RA 
specifies that IOCP is to read the entire A side (the AO, Al, A2, and A3 IOCDS) 
from the processor controller into storage and is to generate configuration 
reports of those data sets. (RPTA is valid only on the A side of a processor 
complex.) 
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RPTB 

RB 
specifies that IOCP is to read the entire B side (the BO, B1, B2, and B3 IOCDS) 
from the processor controller into storage and is to generate configuration 
reports of those data sets. (RPTB is valid only on the B side of a processor 
complex.) 


RPTAB 

RAB 
specifies that IOCP is to read the entire A side (the AO, Al, A2 and A3 IOCDS) 
and the entire B side (the BO, B1, B2 and B3 IOCDS) from the processor 
controller into storage and is to generate configuration reports of those data 
sets. 


This option is only valid if the system is NOT generated in partitioned mode. 


Listing Control Options: 


LINECOUN (55) 
LINECOUN (nn) 


specifies the number of lines (from 10 to 99) that is to be printed on each page. 
The default is LINECOUN (55). If you use this option, note that you must 
specify the number of lines. 


DISK 
DI 
specifies that IOCP is to place the output listing in a file on a minidisk. DISK is 
a default option. 


PRINT 
PR 
specifies that IOCP is to send the output listing to the printer. 


NOPRINT 
NOPR ; 
specifies that JOCP is not to generate any output listing. 


System Terminal Options: 


TERMINAL 

TERM 
specifies that IOCP is to write diagnostic information from the IOCP program to 
your terminal. TERMINAL is a default option. Diagnostic information 
consists of either of the following: 


¢ An IOCP message (see “Chapter 6. IOCP Messages”) and, preceding this 
message, the nonblank line that caused the diagnostic message 


¢ A display of the total message count for the IOCP output 


NOTERM 
specifies that IOCP is to suppress display of diagnostic messages at your 
terminal. 


WARNING 

WARN 
specifies that IOCP is to write IOCP warning messages to the terminal. This 
option is valid only if you specify the TERMINAL option. WARNING is a 
default option. 
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NOWARN 
specifies that IOCP is to suppress the writing of warning messages at your 
terminal. 


Processor Options: 


Select the appropriate processor option to perform an IOCDS generation. The 
IOCDS must be generated on the same processor complex that is designated by the 
selected processor option. 


Select the appropriate processor option to perform syntax checking of input IOCP — 
macro instructions on another processor complex. Syntax checking can be 
performed when the required processor complex is not available. 


Errors will occur if the WRTCDS, WRTAx, WRTBx, or any of the Configuration 
Report options are selected and the processor option that is specified does not match 
the identification of the processor to which the IOCP command is given; errors will 
occur when an attempt is made to read or write an IOCDS if the processor option 
does not match the processor you are running on. 


The valid processor options are: 


308X 
The 308X option specifies that IOCP is to process the command options and 
input file for an IOCDS generation for a processor complex in the 308X series 
or the 908X series. This option is the default if the IOCP command is given, 
without specifying a processor option, to a 308X or 908X processor complex or 
any processor complex that does not support IOCP. 


XXXX 
xXxxx is a four digit number associated with a non-308X processor family 
complex that is supported by IOCP. The xxxx option specifies that IOCP is to 
process the command options and input file for an IOCDS generation for a 
processor complex that is supported by IOCP and is not a 308X or 908X. If the 
IOCP command is given without specifying a processor option on any processor 
complex supported by IOCP, this option will default to the current processor 
ID. 


See the IOCP User’s Guide that is associated with the processor complex for 
which the verification and/or generation is being run. 
Restrictions: 
1, You cannot issue the IOCP command while in the CMS/DOS environment. 


2. If VM/SP or VM/SP HPO Release | is running with single processor mode 
active, do not issue the IOCP command with any write options (WRTCDS, 
WRTAx, or WRTBx) or with any configuration report option (BOTHRPT, 
CDORPT, CDIRPT, RPTAx, RPTBx, RPTA, or RPTB). If single processor 
mode is active and you issue the IOCP command: 


¢ From a virtual machine operating in the V=R area, results are 
unpredictable. 
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¢ From a virtual machine operating in the V=V area, IOCP issues the 
following messages: . 


ICP402I MSSFCALL RETURNED AN UNEXPECTED RESPONSE 
CODE OF 01FO HEX 


ICPQ@51I IOCP TERMINATED. CODE=xx 


IOCP sends a return code 8 to CMS. 


To execute IOCP when single processor mode is active, follow the steps in “Method 
2” under “Subsequent Definition and Replacement of I/O Configuration Data” in 
this chapter. . 


Note: Restriction 2 does not apply to VM/SP HPO Release 2 and subsequent 
releases. If VM/SP HPO (Release 2 or later) is operating in single processor mode, 
and any virtual machine (CMS or MVS/SP) causes IOCP to read from or write to 
the processor controller, CP locates and stops (SIGP STOP) the processor dedicated 
to the virtual = real virtual machine. Then CP executes the read or write function. 
When the service signal external interruption occurs, CP restarts the dedicated 
processor. 
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IOCP Command General Usage Notes 


This section lists some general notes to keep in mind when you issue the IOCP 
command. Some aspects of using the command, vary with the operating system on 
which you run JOCP. For usage notes specific to your operating system, see the 
sections immediately following. 


1. Some IOCP command options cancel other IOCP command options. For this 
reason, when you code the IOCP command, do not combine IOCDS generation 
options with configuration report options. (IOCP allows multiple configuration 
report options.) 


If you inadvertently code conflicting options on the same IOCP command, IOCP 
will use the last-entered of those conflicting options. IOCP issues no warning 
message. 


2. If the IOCDS you wish to write to is write-protected, the write options 
(WRTCDS, WRTAx, and WRTBx) are invalid. (To add or remove the write 
protection for an IOCDS, use the IOCDSM frame.) 


3. The TERMINAL and WARNING options are not active if you issue your own 
CMS FILEDEF SYSPRINT command. 
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a? 


ho 


If you are running IOCP under VM/SP or VM/SP HPO, CP checks your 
privilege class when IOCP issues a DIAGNOSE X‘80’ to read from or write to 
an IOCDS. You must have privilege class E or C to read from an IOCDS; you 
must have privilege class C to write to an IOCDS. If you attempt to read from 
an IOCDS and if you are not a class C or E user, you receive the message 


ICP4021] MSSFCALL RETURNED AN UNEXPECTED RESPONSE 
; CODE OF O1FO HEX 
IOCP prints the message and the response code on the SYSPRINT device. 


If you are not a class C user and you attempt to write to the LOCDS, you 
receive the message 


| ICPO51I IOCP TERMINATED. CODE=09 | 


and IOCP processing stops. 


. If you attempt to update an IOCDS while running on a processor complex that 


does not support IOCP, and do not specify a processor option, you receive the 
following message on the SYSPRINT device and IOCP processing stops. 


ICP4001 READ/WRITE OF IOCDS IS INVALID ON THIS 


PROCESSOR 
ICPO51I1 IOCP TERMINATED. CODE =10 


The messages are printed on the SYSPRINT device. IOCP then stops processing. 


If you request a configuration report while running on a processor complex that 
does not support IOCP, you receive the same message, ICP400I, printed on the 
SYSPRINT device. 


. If you attempt to update an IOCDS or request a configuration report for an 


IOCDS while running on a processor complex that supports IOCP and is not a 
308X or 908X and the 308X processor option was specified, you receive an error 
message. If you attempt to update an IOCDS or request a configuration report 
for an IOCDS while running on a 308X or 908X processor complex and any 
other processor option was specified, you receive an error message. 


ICP400I READ/WRITE OF IOCDS IS INVALID ON THIS. 


~ PROCESSOR 
ICPQ51I IOCP TERMINATED. CODE =10 


The messages are printed on the SYSPRINT device. IOCP then stops processing. 


. If you and another user attempt to read the same IOCDS at the same time, you 


will receive the following message: 


ICP4021 MSSFCALL RETURNED AN UNEXPECTED RESPONSE 


CODE OF 41F0 HEX 


Wait several minutes and again attempt to read that IOCDS by issuing another 
IOCP command. 
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5. You must define your I/O configuration for the processor complex using [OCP 
macro instructions; define that same configuration for VM/SP or VM/SP HPO 
in the DMKRIO file. 


6. If you are attempting to write an IOCDS to the processor controller and either 
the IOCP program abnormally terminates, or you issue the CMS command 
HALT EXECUTION (HX) while IOCP is running, you may prevent another 
authorized user from writing the same IOCDS to the processor controller. Under 
these circumstances the system may have locked the IOCDS for you. The other 
user will receive the following messages: 


ICP402I MSSFCALL RETURNED AN UNEXPECTED RESPONSE 
CODE OF 41F0 HEX 


ICPO511 IOCP TERMINATED. CODE =xx 


where xx is a code that indicates IOCP encountered an error while trying to 
write the IOCDS locked for you. 


The other user will receive these messages each time he tries to write the locked 
IOCDS until you do one of the following: 


¢ Rerun the IOCP program to completion, successfully writing the locked 
IOCDS to the processor controller. 

¢ Issue a SYSTEM RESET command to reset your virtual machine. 

¢ Issue a LOGOFF command to log off your virtual machine. 


The other user will then be able to write the IOCDS that the CP previously 
locked for you. 


lIOCP Command Usage Notes for the VM/XA Systems Facility 
1. If you are running [OCP under the VM/XA Systems Facility, CP checks your 
privilege class when IOCP issues a DIAGNOSE X‘80’ to read from or write to 
an IOCDS. To read from an IOCDS you must have privilege classes F, G, and 
either E or C; to write to an IOCDS you must have privilege classes C, F, and 
G. 


If you attempt to read from an IOCDS and you do not have the required 
privilege classes, you receive the following messages: 


ICP4021 MSSFCALL RETURNED AN UNEXPECTED RESPONSE 


CODE OF 42F0 HEX 
ICPQ951I IOCP TERMINATED. CODE=xx 


where xx is a code that indicates the IOCDS you were trying to read. The 
messages are printed on the SYSPRINT device. IOCP then stops processing. 


If you attempt to write to an IOCDS and you do not have the required privilege 
classes, you receive the following messages: 


ICP402I MSSFCALL RETURNED AN UNEXPECTED RESPONSE 


CODE OF 42F0 HEX 
ICPO511 JOCP TERMINATED. CODE=xx 


where xx is a code that indicates the IOCDS you were trying to write. The 
messages are printed on the SYSPRINT device. IOCP then stops processing. 
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2. If you attempt to update an IOCDS while running on a processor complex that 


does not support IOCP, and do not specify a processor option, you receive the 
following message on the SYSPRINT device and IOCP processing stops. 


ICP400I READ/WRITE OF IOCDS IS INVALID ON THIS 


PROCESSOR 
ICPO51I IOCP TERMINATED. CODE= 10 


If you request a configuration report while running on a processor complex that 
does not support IOCP, you receive the same messages, ICP400I and ICP0S1I, 
printed on the SYSPRINT device. 


. If you attempt to update an IOCDS or request a configuration report for an 
IOCDS while running on a processor complex that supports IOCP and is not a 
308X or 908X and the 308X processor option was specified, you receive an error 
message. 


ICP400I READ/WRITE OF IOCDS IS INVALID ON THIS 
PROCESSOR 
IOCP TERMINATED. CODE= 10 


ICP0511 


If you request a configuration report while running on a processor complex that 
does not support IOCP, you receive the same messages, ICP400I and ICPOS1I, 
printed on the SYSPRINT device. 


If you attempt to update an IOCDS or request a configuration report for an 
IOCDS while running on a 308X or 908X processor complex and any other 
processor option was specified, you receive an error message. 


. If you and another user attempt to read the same IOCDS at the same time, you 


will receive the following message at your terminal: 


HCPPCA837I IOCP READ SEQUENCE REJECTED, LOCKED BY 
userid 


where userid is the userid of the other user. This will be followed by: 


ICP402I MSSFCALL RETURNED AN UNEXPECTED RESPONSE 


CODE OF Q1FO HEX 
ICPQ51I_ OCP TERMINATED. CODE=xx 


where xx is a code that indicates which IOCDS you were trying to read. Wait 
several minutes and again attempt to read that IOCDS by issuing another IOCP 
command. 


. You must define your I/O configuration for the processor complex using IOCP 


macro instructions; define that same configuration for VM/XA Systems Facility 
in the HCPRIO file. 


. If you are running IOCP and it does not complete successfully, you may prevent 


another authorized user from running IOCP. You may be attempting to either 
read or write an IOCDS. IOCP may fail to complete successfully either because 
it abnormally terminates or because you issue the CMS command HALT 
EXECUTION (HX) while IOCP is running. Under these circumstances, CP may 
lock ail IOCDS(s) for you while trying to access one of them. 
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The other user will receive a number of messages. If the other user tries to write 
to an IOCDS, the user will receive the following message: 


HCPPCA836I IOCP WRITE SEQUENCE REJECTED, LOCKED BY 
yourid 


where yourid is your userid. 


If the other user tries to read an IOCDS, the user will receive: 


HCPPCA8371I IOCP READ SEQUENCE REJECTED, LOCKED BY 
yourid 


where yourid is the userid of the other user. 


In either case, the other user will receive the following additional messages: 


ICP402I MSSFCALL RETURNED AN UNEXPECTED RESPONSE 


CODE OF 01FO HEX 
ICPO51I IOCP TERMINATED. CODE=xx 


where xx is a code that indicates the IOCDS the user was trying to access and 
whether the user was trying to read or write. 


The other user will receive these messages each time he tries to run IOCP until 
you do one of the following: 


¢ Rerun the IOCP program to completion. IOCP must complete the same 
operation that was interrupted (read or write) for the same IOCDS. 


e¢ Issue a SYSTEM RESET command to reset your virtual machine. 
¢ Issue a LOGOFF command to log off your virtual machine. 


The other user will then be able to access any of the IOCDS(s). 


Examples of Generating an IOCDS 
Example 1: This example shows the IOCP command options you use to check an 
input file containing only IOCP macro instructions. IOCP displays any warning or 
error messages at your terminal. The output file MIFILE LISTING will contain the 
configuration reports for the configuration described by the input file MIFILE 
IOCP. 


| IOCP MIFILE (NOIGNORE NOWRTCDS LINECOUN (60) | 


where: 


MIFILE 
is the name of the CMS file (filetype IOCP) that contains only IOCP macro 
instructions. 


NOIGNORE 
specifies that IOCP is to flag as errors all data that are not IOCP macro 
instructions. 
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NOWRTCDS 
specifies that IOCP.is not to write the IOCDS generated in storage to an IOCDS 
in the processor controller. 


LINECOUN (60) 
specifies that IOCP is to print 60 lines of output on each page of the 
configuration reports. 


Example 2: This example shows the IOCP command options you use to: 


e Process an input file containing only IOCP macro instructions 
¢ Generate an IOCDS in storage 
e Write the generated IOCDS to the level AO IOCDS in the processor controller 


The output file NEWIOCDS LISTING will contain a listing of the input in 
NEWIOCDS IOCP and configuration reports of the generated IOCDS. 


| IOCP NEWIOCDS (WRTAO 


where: 


NEWIOCDS 
is the name of the CMS file that contains only IOCP macro instructions. 


WRTAO 
specifies that IOCP is to write the IOCDS generated in storage to the level AO 
IOCDS in the processor controller. 


Examples of Producing a Configuration Report 
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Example 1: This example shows the IOCP command options you use to produce a 
report of every IOCDS on the A side of the processor complex. These reports allow 
you to analyze your installation’s present I/O configuration. 


| IOCP IOCDSRPT (RPTA LINECOUN (65) DISK NOTERM | 


where: 


IOCDSRPT 
is the filename of the output file that will contain the configuration reports. 
Note that the filetype will be LISTING. 


RPTA 
specifies that IOCP is to create a listing of every IOCDS on the A side (the AO, 
Al, A2, and A3 IOCDS). 


LINECOUN (65) 
specifies that IOCP is to produce a listing that contains 65 lines of output per 
page. 

DISK 
specifies that IOCP is to send its output to disk. 


NOTERM 


specifies that IOCP is not to display any diagnostic messages at the terminal. 
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Example 2: This example shows the IOCP command options you use to write a test 
configuration source file to the Al IOCDS in the processor controller. 


IOCP PS13 (WRT IGNORE PR 


where: 


PS13 
is the filename of the CMS file containing your input [OCP macro instructions. 
The filetype is IOCP. 


WRT 
specifies that IOCP is to write the configuration defined in PS13 to the level Al 
IOCDS in the processor controller. 


IGNORE 
specifies that IOCP is to ignore all non-IOCP macro instructions and parameters 
contained in the PS13 data set. 


PR 
indicates that IOCP is to send the configuration report of the PS13 data set to 
the printer. 


Chapter 3. Executing the VM Version of IOCP 3-45 


Return Codes 


When you execute the VM version of IOCP, IOCP returns one of the following 
codes at the completion of the job. 


Return Code Description/ Action 
Decimal 


oe IOCP completed the requested function without error. 


IOCP completed the requested functions without error but 
issued one or more warning messages. The warning messages 
in the output listings or the report describe the specific 
conditions that caused the warning. 


IOCP encountered an error and terminated processing before 
completing the requested function. The error message in the 
output listing describes the specific condition that caused the 
error. 


IOCP terminated because the output data set DCB failed to 
open. IOCP was unable to print messages or reports. Ensure 
that the FILEDEF command for the output data set is correct. 
You may query the data definitions for all files by issuing the 
CMS FILEDEF command without operands. 


IOCP terminated because it could not obtain enough storage. 
Define more virtual storage for your virtual machine, re-IPL 
CMS, and issue the IOCP command again. 


In addition to the return codes listed, the CMS-IOCP interface module, DMSICP, 
issues its Own error messages with corresponding return codes for each message. For 
the return codes generated with error messages, see “IOCP Messages (DMSICP 
Prefix)” in “Chapter 6. [OCP Messages.” 
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Methods of Executing the VM Version of lOCP 


This topic suggests ways that you can execute the VM version of IOCP to: (1) 
initially define and check the I/O configuration data for a new processor complex, 
and (2) subsequently redefine and replace the I/O configuration on an installed 
processor complex. 


Initial Definition of 1/O Configuration Data 
There are two methods you can use to initially define and validate the I/O 
configuration data for a new processor complex: 


e If you have time to prepare an IOCP input file on an existing system before 
installing the processor complex, use Method One. 


e If you can use the starter IOCDS shipped with the processor complex, use 
Method Two. 


Method One: 


Before installing the processor complex, you can create an IOCP input file on an 
existing system. The customer engineer (CE) uses this input file during the 
installation of the new processor complex. To prepare an input file, follow these 
steps: 


1. Determine, from your physical plan, the I/O configuration requirements that 
must be met in order to install the processor complex. 


2. Prepare an input file of IOCP macro instructions that define your I/O 
configuration and system requirements. The customer engineer will use this file 
when he installs the processor complex. For a sample input file containing 
IOCP macro instructions, see Figure B-4 in Appendix B. 


3. Check the IOCP macro instruction input by executing the IOCP command under 
CMS. Code NOWRTCDS and NOIGNORE on the IOCP command. This 
command allows you to check the syntax of the IOCP macro instructions as well 
as to check the configuration reports for the desired configuration data. 


Note: The I/O information in the DMKRIO file (for VM/SP or VM/SP HPO) 
or HCPRIO file (for the VM/XA Systems Facility) used in system generation 
should correspond to the information you code in the IOCP macro instructions. 
Figure B-5 in Appendix B contains a sample DMKRIO file that corresponds to 
the sample IOCP input file shown in Figure B-4. Figure B-6 in Appendix B 
contains a sample HCPRIO file that corresponds to the sample IOCP input file 
shown in Figure B-4. 


4. If there are any errors in the IOCP macro instructions, correct the errors and 
rerun IOCP (Step 3). 


5. Analyze the IOCP configuration reports (produced in Step 3) to ensure that the 
desired I/O configuration is defined. If necessary, revise the IOCP macro 
instructions and rerun IOCP. 


6. Create a tape or card deck of IOCP macro instructions from the input file you 
have created. 


Note: During the physical installation of the processor complex, the CE uses 
your validated input deck (with the stand-alone version of JOCP) to configure 
and test the I/O configuration for the new processor complex. An example for 
the CE is provided under “Generating an IOCDS on a New Processor Complex” 
in Chapter 4. 
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Method Two: 


The processor complex is shipped with a starter IOCDS. You can decide whether or 
not this starter IOCDS meets your I/O needs. To use the starter IOCDS, follow 
these steps: 


1. Determine the 1/0 devices your installation uses and whether the starter IOCDS > 
defines these devices. If you will generate VM/SP or VM/SP HPO, make sure 
the addresses in the IOCDS correspond to the addresses for these devices in the 
DMKRIO file. If you will generate the VM/XA Systems Facility, make sure the 
addresses in the IOCDS correspond to the addresses for these devices in the — 
HCPRIO file. 


2. Proceed withthe installation of the processor complex if the starter IOCDS 
defines enough DASD to IPL a VM/SP, VM/SP HPO, or VM/XA Systems 
Facility system. Use the IOCDS shipped with the processor complex. 


3. Reconfigure your I/O, once you initialize VM/SP, VM/SP HPO, or the VM/XA 
Systems Facility according to the particular physical configuration of your 
installation. (See “Subsequent Beams and Replacement of I/O Configuration 
Data” in this chapter.) 


Note: If the starter IOCDS shipped with the processor complex does not correspond 
to your particular I/O configuration, your customer engineer must execute the 
stand-alone version of IOCP. (See “Chapter 4. Executing the Stand-Alone Version 
of IOCP”.) | 
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There are two methods you can use to replace the existing I/O configuration data on 


a processor complex: 


¢ If VM/SP or VM/SP HPO Release | 1s not running in single processor mode, or 
you have installed VM/SP HPO Release 2 or a subsequent release, use Method 
One. . 


¢ If VM/SP or VM/SP HPO Release 1 is running in single processor mode, use 
Method Two. 


¢ If you are running the VM/XA Systems Facility, use Method One. 
Method One: 


The following steps describe how your installation can replace the existing I/O 
configuration data on a processor complex when VM/SP or VM/SP HPO Release 1 
is not running in single processor mode. You may follow these steps for VM/SP 
HPO Release 2 and subsequent releases, regardless of the system mode. You may 
also follow these steps for the VM/XA Systems Facility: — 


i: Update the input file that contains the IOCP macro instructions to reflect your 
new I/O. configuration. Figure B-4 in Appendix B contains a listing of a sample 
input file. 


2. Execute the VM version of IOCP to check the caput file you updated in Step | 1. 
Use the NOWRTCDS option on the CMS IOCP command. 


3. Correct any errors on the IOCP macro instructions and rerun IOCP (Step 2). 


4. Analyze the IOCP configuration reports (produced in Step 2) to ensure that the 
desired I/O configuration is defined. If necessary, revise the IOCP macro 
instructions and rerun IOCP (Step 2). — 
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5. Execute the IOCP program by issuing the IOCP command with a write option 
(WRTCDS, WRTAx, or WRTBx). This option writes the I/O configuration to 
the specified IOCDS in the processor controller. All users running under VM/SP 
or VM/SP HPO must have privilege class C to write. All users running under the 
VM/XA Systems Facility must have privilege classes C,.F, and G to write. 


Note: Continue with Steps 6 through 11 when you wish to use the new IOCDS 
created in Step 5. Perform these steps at a convenient time, because these steps 
require disrupting installation operations. 


6. Revise the real I/O configuration file to reflect the changes made by IOCP. The 
real I/O configuration file is DMKRIO for VM/SP and VM/SP HPO; for the 
VM/XA Systems Facility, itis HCPRIO. Figure B-5 in Appendix B contains a 
sample DMKRIO listing that corresponds to the IOCP listing mentioned in Step 
1 (Figure B-1). Figure B-6 in Appendix B contains a a t HCPRIO listing 
that also corresponds to Figure B-1. 


7. Generate the new VM/SP, VM/SP HPO, or VM/XA Systems Facility system. 
8. Shut down VM/SP, VM/SP HPO, or the VM/XA Systems Facility. 


9. Perform a power-on reset of the processor complex with the new IOCDS 
specified as the source of your configuration data. You use the IOCDSM 
(SYS021) frame to select the active IOCDS and the CONFIG (SYS020) frame to 
perform a power-on reset. (See the operator’s guide for the system console that 
applies to your processor complex.) 


10. Load (IPL) VM/SP, VM/SP HPO or the VM/XA Systems Facility. 


11. Test the new configuration. Follow the procedures established for your 
installation. 


12. If your processor complex has only a level AO and Al (LVLO and LVL1) 
IOCDS, switch the two data sets after the new I/O configuration has been tested. 
To switch data sets, use action 3, SWITCH DS A/B, on the CONFIG (SYS020) 
frame. This action allows you to execute IOCP again and to write to and test 
another I/O configuration in the Al IOCDS. 


13. Save the file you used in Step 2 to provide a backup. 
Method Two: 


This method shows how an installation can redefine and replace an existing I/O 
configuration data set when VM/SP or VM/SP HPO Release 1 is running in single 
processor mode. Single processor mode allows an installation to dedicate a 
processor to an MVS V=R virtual machine. When single processor mode is active, 
do not issue an IOCP command with a write option or a configuration report 
option. (Note that the MVS V=R user cannot run the MVS version of IOCP when 
single processor mode is active if the user specifies that IOCP is to write to the 
processor controller or read from the processor controller.) 


Note: See “Restrictions” earlier in this chapter for information about running IOCP 
under VM/SP HPO in single processor mode. 
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- Follow these steps: © 


You may perform Steps 1 through 5 when single processor mode is active. Because 
you can do these steps while single processor mode is active, you can check IOCP 
macro instructions for errors without disrupting normal installation operations. 


I. 


by 


Update the input file that contains the IOCP macro instructions to reflect your 
new I/O configuration. Figure B-4 in Appendix B contains a listing of a sample 
IOCP input file. : 


. Execute the VM version of IOCP to check the input file you updated in Step 1 


above. Use the NOWRTCDS option on the CMS IOCP command. Do not 
specify any configuration report options on the IOCP command. 


. Correct any errors on the IOCP macro instructions and rerun IOCP (Step 2). 


. Revise the DMKRIO file to reflect the changes made by IOCP. Figure B-S in 


Appendix B contains a sample DMKRIO listing that corresponds to the IOCP 
listing mentioned in Step I. 


Generate the new VM/SP or VM/SP HPO system. 


Steps 6 through 8 require disrupting operation of the MVS virtual machine. 


6. 


iP 
8. 


Quiesce the MVS system, then reset the MVS virtual machine. The MVS V=R 
user must issue the CP command SYSTEM RESET or LOGOFF. 


Turn single processor mode off. 


Execute the IOCP program by issuing the IOCP command with a write option 
(WRTCDS, WRTAx, or WRTBx). This option writes the I/O configuration to 
the specified IOCDS in the processor controller. Note that you must have 
privilege class C. 


You perform Steps 9 through 14 when you wish to use the new IOCDS you created 
in Step 8. Perform these steps at a convenient time, because these steps require 
disrupting installation operations. 


9: 
10. 


Ei 
12. 


£3: 


14. 


IS: 
16. 
Ly. 


Shut down VM/SP or VM/SP HPO. 


Perform a power-on reset of the processor complex with the new IOCDS 
specified as the source of your configuration data. You use the IOCDSM 
(SYS021) frame to select the active IOCDS and the CONFIG (SYS020) frame to 
perform the power-on reset. (See the operator’s guide for the system console 
that applies to your processor complex.) 


Load (IPL) VM/SP or VM/SP HPO. 


Test the new configuration. Follow the procedures established for your 
installation. 


If your processor complex has only a level AO and Al (LVLO and LVL1) 
IOCDS, switch the data sets after the new I/O configuration has been tested. To 
switch data sets, use action 3, SWITCH DS A/B, on the CONFIG (SYS020) 
frame. This action allows you to execute IOCP again and to write to and test 
another I/O configuration in the Al IOCDS. 


Vary the second processor logically offline by issuing the command VARY 
OFFLINE PROCESSOR VLOG. 


Turn single processor mode on. 
Load (IPL) MVS. 


Save the file you used in Step 2 to provide a backup. 
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Chapter 4. Executing the Stand-Alone Version of |OCP 


The stand-alone version of IOCP is shipped with the processor complex as a 
software program in a partitioned data set on the integrated processor controller file 
in the processor controller. You execute the stand-alone version of IOCP to define 
1/O configuration data when you are operating your system before installation of 
MVS, VM/SP, VM/SP HPO or the VM/XA Systems Facility, or when you are 
operating your system with a control program other than these. The stand-alone 
version can run in either 370 mode or 370-XA mode. 


You start and control the stand-alone version of IOCP from the system console or 
the service support console on the processor complex. When started, IOCP displays 
the IOCP primary menu (shown in Figure 4-4), which lists the available functions. 
From this menu, you select the function you want to perform. IOCP then displays 
menus on which you enter data for a specific function, or enter a screen command to 
select another function. 


Note: When you enter configuration data on the menus, the characteristics, values, 
and restrictions that apply to the configuration data you enter for channel paths, 
control units, and I/O devices are the same as those described for the macro 
instructions. See “Specifying IOCP Macro Instructions” in Chapter 2 (MVS) or 
Chapter 3 (VM) for full information on specifying configuration data on the 
CHPID, CNTLUNIT, and IODEVICE macro instructions. 


To help you use the information in this chapter, the next topic provides a map of 
IOCP functions with references to the topics and menus in this chapter. The other 
topics in this chapter describe: 


How to start and end IOCP 

The layout of the IOCP menus 

The IOCP screen commands 

The menus displayed by IOCP 

Selected examples of executing functions of IOCP 
How to dump the IOCP storage area 

The wait state codes issued by IOCP 
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Guide to Using the Stand-Alone Version of IOCP 


To help you use the information in this chapter, the following diagram provides a 
map of the IOCP functions with references to the topics and figures in this chapter 
that describe how to perform the function. 


Start stand-alone |OCP (See topic ‘’Starting and Ending |OCP’’) 


| Is this a generation of an initial |OCDS? 


NO 
YES See topic ‘‘Generating an |OCDS ona 


jean ; locDs? New Processor Complex’ tater in this 
s this a replacement chapter: 


NO 
ue See topic ‘Replacing an IOCDS by Using 


Card-Image Input’’ later in this chapter. 


NO YES . 
YES NO 
Select primary menu option 7 — then see figure 4-17 
See figure 4-16 


Is this a screen entry change to the |OCDS? (display, add, alter, or delete function) 


- z See the note in the topic 
Is the LOCDS to be changed in storage? “Primary Menu” later in 


YES NO this chapter. 


Terminate l|OCP? 


NO YES Select primary menu option 7 — then see figure 4-17 


Is this a display function? 


NO YES 


Is this an add function? 


NO | YES 


Enter END — 


Select a function press ENTER 


on the primary 

menu (figure 4-1) eg the. 
lOCDS was 
updated — 
test the new 
configuration 
(See steps 11 


See figure 4-2 


See figure 4-3 


the topic NO YES 

“Replacing See figure 4-4 
an 1OCDS by : . 

Using Card- 

Image Input” NO YES 

later in this See figure 4-5 
chapter.) 


Are updates complete? 


YES 


.Has updated 1OCDS been written to the processor controller? 
YES NO ; 
Select primary menu option 8 — then see figure 4-18 


ls a configuration report needed? 


NO YES 


See figure 4-16 
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Starting and Ending lIOCP 


To start the stand-alone version of IOCP, you must use a console correctly 
configured with the processor that will execute IOCP. Although you can execute 
IOCP on only one processor at a time, the stand-alone version of IOCP requires the 
entire processor complex to operate. (The command IOCPn causes a system reset 
and the clearing of storage before loading IOCP.) 


The following steps describe how you start the stand-alone version of IOCP on the 
system console or the service support console. 


1. Determine if there are any analysis routines (ARs) currently running by hitting 
the ATTN key on the service console. If there are analysis routines running, 
you will receive the following message: 


"ATTN Flag now set 
To continue, enter DGO. To terminate, enter DEND." 
If you do not receive this message, go to Step 2. 


Either enter DGO to allow the analysis routines to complete and run JOCP at a 
later time, or enter DEND to cancel the analysis routines. (The analysis routine 
that is currently running will complete.) Go to Step 2. 


If you cancel the analysis routines to run IOCP, restart the routines at the 
completion of IOCP by entering: 


"F MMCO60" 


and selecting “Resume LOGOUT Analysis”. 
This will resume LOGOUT analysis. 


2. Key in the following console command, replacing n with the number of the 
processor (0, 1, 2, or 3) that will execute IOCP. (The A side has processors 0 and 
2; the B side has processors | and 3. A uniprocessor has only processor 2.) 


IOCPn 


Press ENTER. 
3. Wait for a response. 


If the console is in program mode, IOCP displays the primary menu 
(Figure 4-4). Go to Step 5. 


If the console is not in program mode, IOCP displays the following message: 


ICP501A TYPE "PRG": PRESS "ALT", "CMD" KEYS: 


TYPE "PRGATTN": PRESS "ENTER" 
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4. Respond to message ICPS01A by performing the following steps, which put the 
console in program mode and cause a program attention. 


a. To put the console in program mode, key in the following console 
command: 


PRG 


b. To display the following message, press and hold down the ALT key and 
then press the CMD key while holding down the ALT ‘key. 


CONSOLE MODE CHANGED 


c. To cause a program attention, key in the following console command: 


PRGATIN 


d. Press ENTER. 


5. IOCP displays the primary menu (Figure 4-4) and you can start operating 
IOCP. 


For you to communicate with IOCP, the console must be in program mode. 
Whenever the console is in FDC (frame dependent command) mode and IOCP tries 
to change any line in the display other than the message line, the processor displays 
message CF INVOCATION ERROR. RC=52. This message means the console is 
not in program mode. IOCP also displays message ICPSO1A (except when IOCP is 
changing line 11 of Figure 4-20 and Figure 4-21). Use Steps 3a and 3b to put the 
console into program mode. To end IOCP operation, enter the END screen 
command on any IOCP menu. IOCP enters a disabled wait state and the audible 
alarm may sound. To reset the audible alarm, you must be in FDC mode (the 
console is still in program mode). To take the console out of program mode; key in 
FDC, press and hold down the ALT key, and press the CMD key while holding 
down the ALT key. Once you are in FDC mode, type RSTALM on the bottom line 
and press ENTER to reset the alarm. To restart IOCP (when IOCP is in storage 
and the console is in FDC mode), key in SYSRESET and press ENTER. Then key 
in RESTART CPn, where n is the processor number (0, 1, 2, or 3), and press 
ENTER. IOCP displays message ICP501A. (When you restart IOCP, the IOCDS 
in storage is reinitialized.) 
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Layout of the Menu Screens 


IOCP uses 24 lines to display menus. The lines contain the following data: 


Figure 4-1. Layout of Menu Screen 
Line Description 


I/O CONFIGURATION PROGRAM 


IOCP menu name (function to be performed) 
3 


blank 

4-18 variable - contains specific instructions for the menus. You use these 
lines to enter configuration data and to select options. 

19 blank a 

20-21 lists the IOCP screen commands available for you to enter on line 24 


of the menu currently displayed. Screen commands allow you to 
select and change the functions you want to perform. 


2 system status indicators - not used by IOCP. 


displays the messages that indicate error conditions or the completion 


of requested functions. 


24 used to enter IOCP screen commands. 


Although they do not appear on the IOCP screens, line numbers are shown next to 
the screens in this manual and are referred to in the text to describe the menus. 
When a menu is displayed, the cursor position is to the right of the arrow where you 
can start to enter data. In the event of an entry error, the cursor position is at the 
incorrect data. Figure 4-4 through Figure 4-22 show the IOCP menus. In 

Figure 4-9 through Figure 4-11, the optional 370 information (channel number and 
channel set) is information required only for 370 mode operation. In Figure 4-15 
through Figure 4-17, the optional information (preferred path) applies only to 
370-XA mode operation. 
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Screen Commands 


The screen commands that you can issue when a specific menu is displayed are 
shown on lines 20 and 21 of the menu. To issue a screen command, enter the 
command on line 24 and press ENTER. 


The ADD, ALTER, and DISPLAY screen commands can be entered in the form 
“command = value”. This “command = value” screen command allows you to switch 
to or repeat a function without the need to return to the selection menu or primary 
menu. For example, if you have the control unit display menu (Figure 4-12) on the 
screen and want to add control unit number 2AA, enter ADD =2AA and press 
ENTER to select the add control unit menu (Figure 4-13) for control unit number 
2AA. 


The IOCP screen commands are: 


Figure 4-2 (Page 1 of 2). IOCP Screen command 
ADD 


Terminates the function in use for the menu currently 
displayed and selects the add selection menu _ 
(Figure 4-6). 


ADD = value 


Terminates the function in use for the menu currently 
displayed and performs the function of the add 
selection menu (Figure 4-6) for the specified value. 


A = value Enter ADD = value on the display, add, or alter 
channel path menus (Figure 4-9, Figure 4-10, or 
Figure 4-11) to select the add channel path menu 
(Figure 4-10) for the channel path specified by value. 
Enter ADD = value on the display, add, or alter 
control unit menus (Figure 4-12, Figure 4-13, or 
Figure 4-14) to select the add control unit menu 
(Figure 4-13) for the control unit specified by value. 
Enter ADD = value on the display, add, or alter I/O 

_ device menus (Figure 4-15, Figure 4-16, or 

Figure 4-17) to select the add I/O device menu 
(Figure 4-16) for the I/O device specified by value. 


ALTER Terminates 
the function in use for 
the menu currently 
displayed and selects 
the alter selection 
menu (Figure 4-7). 


ALTER = value Use ALTER = value to switch to or repeat the alter 
function in the same manner as described for 


ADD = value. 


FC 
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Figure 4-2 (Page 2 of 2). IOCP Screen command 


DELETE Terminates the function in use for the menu currently 
displayed and selects the delete selection menu _ 
(Figure 4-8). . 

DISPLAY Terminates the function in use for the menu currently 


displayed and selects the display selection menu 


(Figure 4-5). 
DISPLAY = value 


Use DISPLAY = value to switch to or repeat the 
display function in the same manner as described for 
ADD = value. 


END Terminates IOCP. If you-have modified the IOCDS 
in storage, and have not written the IOCDS to an 
IOCDS in the processor controller, IOCP does not 
terminate until you respond to the end IOCP menu 
(Figure 4-22). When IOCP enters the disabled wait 
state, the audible alarm may sound. If the alarm 
sounds, put the console into FDC mode, type 
RSTALM on the bottom line, and press ENTER to 
reset the alarm. 


D= value 


MENU Terminates the function in use for the menu currently 
displayed and displays the primary menu 
(Figure 4-4). 


RESHOW Clears the screen and restores the previous IOCP 
menu to the screen. IOCP restores user-entered data, 
if IOCP received the data. Any message previously 
displayed is not reshown. 


WRITE Terminates the function in use for the menu currently 
displayed and selects the write IOCDS to the 
processor controller file menu (Figure 4-21). 


a ee eee yee 


Chapter 4. Executing the Stand-Alone Version of OCP 4-7 


Menu Screens 


Primary Menu 


This topic describes the menus displayed by IOCP and explains how you use the 
menus. _ 


- The primary menu shown in Figure 4-4 appears when you start IOCP or issue the 


MENU screen command to request the primary menu... _ 


You select the function that you want to perform by keying in a menu number (1 
through 8) on line 14 and pressing ENTER. 


The menu displayed when you enter a number on the primary menu is: 


Figure 4-3. Primary Menu 


Menu Menu 
Number Displayed 


Function 


Used to display configuration 
data from the IOCDS in 
storage. 


Display Selection (Figure 4-5) 


Add Selection (Figure 4-6) Used to add configuration 


data to the IOCDS in storage. 


Used to alter configuration 
data in the IOCDS in storage. 


Alter Selection (Figure 4-7) 


Used to delete configuration 


Delete Selection (Figure 4-8) 
data from the IOCDS in 


storage. 
Build IOCDS from Cards Used to read card-image 
(Figure 4-18) macro instructions from a card 


reader or magnetic tape, 
generate an IOCDS in storage, 
and produce reports of the 
generated IOCDS. 


Used to produce configuration 
reports from the IOCDS in 
storage on a channel-attached 
printer, or to access the service 
aid facility to swap channel 
path information in the 
IOCDS and then print reports. 


Read IOCDS from the 
Processor Controller File 
(Figure 4-20) 


Used to read one or more 
IOCDS(s) from the processor 
controller into the IOCDS 
storage area. 


Used to write the IOCDS in 
storage to one or more 
IOCDS(s) in the processor 
controller. 


Write IOCDS to the Processor 
Controller File (Figure 4-21) 


Print IOCDS Configuration 
Reports with Service Aid 
Facility (Figure 4-19) 

7 
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1/0 CONFIGURATION PROGRAM 
PRIMARY MENU 


SELECT MENU NUMBER AND ENTER BELOW: 

. DISPLAY CHANNEL PATH, CONTROL UNIT, OR 1/0 DEVICE INFORMATION 
. ADD CHANNEL PATH, CONTROL UNIT, OR I/O DEVICE | 
. ALTER CHANNEL PATH, CONTROL UNIT, OR I/0 DEVICE 

. DELETE CHANNEL PATH, CONTROL UNIT, OR 1/0 DEVICE 

. BUILD IOCDS FROM CARDS 

- PRINT IOCDS CONFIGURATION REPORTS WITH SERVICE AID FACILITY 

. READ IOCDS FROM THE PROCESSOR CONTROLLER FILE 

. WRITE IOCDS TO THE PROCESSOR CONTROLLER FILE 


pl 
2 
3 
4 
5 
6 
7 
8 


ENTER MENU NUMBER ==> 


END RESHOW 
MENU 

system status 

message line 

command line 


4-4. Primary Menu Screen 


Note: IOCP processes your requests to display, add, alter, delete, and print 
configuration data (menu numbers 1, 2, 3, 4, and 6) from the IOCDS located in 
central storage. This IOCDS in storage represents one of the following: 


* The IOCDS previously read into storage using the read IOCDS from the 
processor controller file menu (number 7). 


¢ The IOCDS previously generated in storage from card-image input using the 
build IOCDS from cards menu (number 5). 


¢ A null IOCDS in storage created when you start IOCP. 


If you modify the IOCDS in storage and want to write the modified IOCDS to one 
or more IOCDS(s) in the processor controller file, use menu number 8. 


See the examples later in this chapter for detailed information on executing functions 
of IOCP. 
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Display Selection 


The screen shown in Figure 4-5 appears when you enter menu number | on the 
primary menu screen (Figure 4-4) or enter the DISPLAY screen command. 


You use this menu to select the data you want to display from the IOCDS in 
storage. . 


On line 5, 6, or 7, key in the channel path identifier, control unit number, or I/O 
device address/number for the record you want to display. 


Press ENTER. IOCP displays the requested data on the channel path display screen 
(Figure 4-9), the control unit display screen (Figure 4-12), or the I/O device display 
screen (Figure 4-15). 


2 
3 

4 ENTER DISPLAY SELECTION FOR ONLY ONE OF THE FOLLOWING: 
5 CHANNEL PATH ID (2 HEX) ==> 

6 CONTROL UNIT NUMBER. _( 

7 

8 


DEVICE 


20 ADD 


22 system status 
23 message line 
command line 


1/0 CONFIGURATION PROGRAM 
DISPLAY SELECTION 


1 T0 3 HEX) ==> 
ADDRESS/NUMBER__(1 TO 3 HEX) ==> 


END RESHOW 


21 ALTER DELETE MENU 


Figure 4-5. Display Selection Screen 
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Add Selection 


The screen shown in Figure 4-6 appears when you enter menu number 2 on the 
primary menu screen (Figure 4-4) or enter the ADD screen command. 


You use this menu to specify the channel path, control unit, or I/O device that you 
want to add to the IOCDS in storage. Before adding a control unit to the IOCDS, 
you must add the channel path(s) to which the control unit attaches. Before adding 
an I/O device, you must add the control unit(s) to which the I/O device is assigned. 


On line 5, 6, or 7, key in the channel path identifier, control unit number, or I/O 
device address/number for the record you want to add. 


Press ENTER. IOCP displays the add channel path screen (Figure 4-10), the add 
control unit screen (Figure 4-13), or the add I/O device screen (Figure 4-16) to 
allow you to enter complete data for the record you want to add. 


1/0 CONFIGURATION PROGRAM 
ADD SELECTION 


ENTER ADD SELECTION FOR ONLY ONE OF THE FOLLOWING: 
CHANNEL PATH ID (2 HEX) ==> 
CONTROL UNIT NUMBER (1 TO 3 HEX) ==> 
DEVICE ADDRESS/NUMBER__(1 TO 3 HEX) ==> 


DISPLAY END RESHOW 
ALTER DELETE MENU 
system status 
message line 
command line 


Figure 4-6. Add Selection Screen 
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Alter Selection 
The screen shown in Figure 4-7 appears when you enter menu number 3 on the 
primary menu screen (Figure 4-4) or enter the ALTER screen command. 


You use this menu to select and identify the channel path, control unit, or I/O device 
whose data you want to alter in the IOCDS in storage. 


On line 5, 6, or 7, key in the channel path identifier, control unit number, or I/O 
device address/number that identifies the record that you want to alter. 


Press ENTER. IOCP displays the alter channel path screen (Figure 4-11), the alter 
control unit screen (Figure 4-14), or the alter I/O device screen (Figure 4-17) to 
allow you to alter the existing data for the record selected. 


1/0 CONFIGURATION PROGRAM 
ALTER SELECTION 


ENTER ALTER SELECTION FOR ONLY ONE OF THE FOLLOWING: 
CHANNEL PATH ID (2 HEX) ==> 
CONTROL UNIT NUMBER__ (1 TO 3 HEX) ==> 
DEVICE ADDRESS/NUMBER__(1 TO 3 HEX) ==> 


ADD DISPLAY END RESHOW 
. DELETE MENU 

system status 

message line 

command line 


Figure 4-7. Alter Selection Screen 
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| Delete Selection 


20 ADD DISPLAY END RESHOW 


21 ALTER 

22 system status 
23 message line 
24 command line 


ae Ee 


rd 

3 

4 ENTER DELETE SELECTION FOR ONLY ONE OF THE FOLLOWING: 
5 CHANNEL PATH ID (2 HEX) ==> 
6 CONTROL UNIT NUMBER_ ( 
7 DEVICE ADDRESS/NUMBER__( 
8 


The screen shown in Figure 4-8 appears when you enter menu number 4 on the 
primary menu screen (Figure 4-4) or enter the DELETE screen command. 


You. use this menu to delete a channel path, control unit, or I/O device record from 
the IOCDS in storage. 


If you delete a channel path, [OCP deletes all references to that channel path from 
control unit and I/O device records. Any control unit and/or I/O device record that 
references only that channel path will be deleted entirely. 


If you delete a control unit, [OCP deletes all references to that control unit from I/O 
device records. Any I/O device record that references only that control unit will be 


deleted entirely. 


On line 5, 6, or 7, key in the channel path identifier, control unit number, or I/O 
device address/number for the record that you want to delete. 


Press ENTER. The selected record is deleted from the IOCDS in storage. 


1/0 CONFIGURATION PROGRAM 
DELETE SELECTION 


TO 3 HEX) ==> 
TO 3 HEX) ==> 


1 
1 


MENU 


Figure 4-8. Delete Selection Screen 
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Channel Path Display 
Thé screen shown in Figure 4-9 appears when you have entered a channel path 
identifier on line 5 of the display selection screen (Figure 4-5) or entered the 
DISPLAY = value screen command. 


This screen displays, to the right of the arrows, the data for the requested channel 
path. The optional information (channel number and channel set) is displayed only 
if it was specified. For 370-XA mode, the optional information is optional. For 370 
mode, the optional information is information required for the processor to access 
the devices attached to the channel path. 


Enter a screen command and press ENTER to select another menu. 


1/0 CONFIGURATION PROGRAM 


1 

Z ~ CHANNEL PATH DISPLAY 

3 j 

4 REQUIRED INFORMATION: 

5 CHANNEL PATH ID (2 HEX) ==> 
6 CHANNEL TYPE (BL,BY) ==> 
7 

8 OPTIONAL 370 INFORMATION: 

9 CHANNEL NUMBER (1 HEX) ==> 
10 CHANNEL SET (0,1) ==> 


20 ADD DISPLAY END — RESHOW 
21 ALTER ~ DELETE MENU 

22 system. status 

23 message line 
command line 


Figure 4-9. Channel Path Display Screen 


4-14 [OCP User’s Guide and Reference 


Add Channel Path 
_ 3s The screen shown in Figure 4-10 appears when you have entered a channel path 

| identifier on line 5 of the add selection screen (Figure 4-6) or entered the 

ADD = value screen command. | 


You use this menu to add a channel path to the IOCDS in storage. 


On line 5, IOCP displays the channel path identifier of the channe] path you are 
adding. . 


On lines 6, 9, and 10, key in the channel path information for the channel path that 
you want to add. For 370-XA mode, the optional information is optional. For 370 
mode, the optional information is required for the processor to access the devices 
attached to the channel path. 


Press ENTER to add the channel path record to the IOCDS in storage. 


1/0 CONFIGURATION PROGRAM 
ADD CHANNEL PATH 


ENTER REQUIRED INFORMATION: 
CHANNEL PATH ID (2 HEX) 
CHANNEL TYPE (BL, BY) 


ENTER OPTIONAL 370 ASSIGNMENT: 
CHANNEL NUMBER (1 HEX) 
CHANNEL SET (0,1) 


ADD DISPLAY END RESHOW 
ALTER DELETE MENU 

system status 

message line 

command line 


Figure 4-10. Add Channel Path Screen 
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Alter Channel Pa 


ENTER REQUIRED 


th 


The screen shown in Figure 4-11 appears when you have entered a channel path 
identifier on line 5 of the alter selection screen (Figure 4-7) or entered the 
ALTER = value screen command. 


You use this menu to alter the definition of an existing channel path in the IOCDS 
in storage. When this screen is displayed, it shows the existing information for the 
channel path you have selected to alter. 


On line 5, IOCP displays the channel path identifier of the channel path you are 
altering. You cannot alter the channel path identifier itself on this screen. To alter 
the channel path identifier, delete the existing definition of the channel path from the 
IOCDS in storage and add a new one. 


On lines 6, 9, and 10, IOCP displays the existing channel path information, which 
you can alter by keying in new information to define the channel path. The data 
that you can alter is intensified on the screen. . 


For 370-XA mode, the optional information (lines 9 and 10) is optional. 


For 370 mode, the optional information is information required for the processor to 
access the device attached to the channel path. 


Press ENTER to add the altered channel path record to the IOCDS in storage. 


1/0 CONFIGURATION PROGRAM 
ALTER CHANNEL PATH 


INFORMATION: 


CHANNEL PATH ID (2 HEX). 
CHANNEL TYPE _(BL,BY) 


ENTER OPTIONAL 


370 ASSIGNMENT: 


CHANNEL NUMBER (1 HEX) 
CHANNEL SET (0,1) 


ADD DISPLAY END RESHOW 
ALTER DELETE MENU 


system status 
message line 
command line 


Figure 4-11. Alter Channel Path Screen 
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Control Unit Display 
The screen shown in Figure 4-12 appears when you have entered a control unit 
number on line 6 of the display selection screen (Figure 4-5) or entered the 
DISPLAY = value screen command. 


This screen displays, to the right of the arrows, the data for the requested control 
unit. 


Enter a screen command and press ENTER to select another menu. 


1/0 CONFIGURATION PROGRAM 


2 CONTROL UNIT DISPLAY 

3 

4 REQUIRED INFORMATION: 

5 CONTROL UNIT NUMBER__(1 TO 3 HEX) ==> 

6 CU TYPE NUMBER (1 TO 5 ALPHA) ==> 

7 CONTROL UNIT SHARED? (Y,YB,N) ==> 

8 PROTOCOL (D,S,S4) ==> 

9 CHPID #1 (2 HEX) ==> 

10 UA SET #1: FROM (2 HEX) ==> 

11 UA SET #1: TO (2 HEX) ==> 

12 ADDITIONAL CHPID(S): 

13 CHPID#2 => CHPID#3 => CHPID#4 => 
14 ADDITIONAL UNIT ADDRESS SET(S): 

15 SET FROM TO SET FROM TO SET FROM TO 
16 2 => 3 => 4 => 

17 5 => 6 => 7 => 

18 8 => 


20 ADD DISPLAY END RESHOW 
21 ALTER DELETE MENU 

22 system status 
23 message line 
command line 


Figure 4-12. Control Unit Display Screen 
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Add Control Unit 
The screen shown in Figure 4-13 appears when you have entered a control unit 
number on line 6 of the add selection screen (Figure 4-6) or entered the 
ADD = value screen command. 


You use this menu to add a control unit to the IOCDS in storage. Before adding a 
control unit, you must add the channel path(s) to which the control unit attaches. 


On line 5, IOCP displays the control unit number of the control unit you are adding. 


On lines 6 through 18, key in the control unit information for the control unit that 
you want to add. If the control unit connects to more than one channel path, enter 
the additional channel path identifiers (chpids) on line 13. If the control unit can 
recognize sets of unit addresses, enter the additional sets on lines 16 through 18. 
You can specify a maximum of eight sets of addresses. 


Press ENTER to add the control unit record to the IOCDS in storage. 


1 1/0 CONFIGURATION PROGRAM 

2 ADD CONTROL UNIT 

3 0 

4 ENTER REQUIRED INFORMATION: 

5 CONTROL UNIT NUMBER___(1 TO 3 HEX) ==> 
6 CU TYPE NUMBER (1 TO 5 ALPHA) ==> 
7 CONTROL UNIT SHARED? (Y,YB,N) ==> 
8 PROTOCOL (D,S,S4) ==> 
9 CHPID #1 (2 HEX) ==> 
10 UA SET #1: FROM (2 HEX) ==> 
11 UA SET #1: TO (2 HEX) ==> 
12 ENTER ADDITIONAL CHPID(S): 

13 CHPID#2 => CHPID#3 => CHPID#4 => 
14 ENTER ADDITIONAL UNIT ADDRESS SET(S): 

15 SET FROM TO SET FROM TO SET FROM TO 
16 2 => 3 => 4 => 
17 5 => 6 => 7 => 
18 8 => 

19 
20 ~ ADD DISPLAY END — RESHOW 
21° ALTER DELETE MENU 


22 system status 
23 message line 
24 command line 


Figure 4-13. Add Control Unit Screen 
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Alter Control Unit 
The screen shown in Figure 4-14 appears when you have entered a control unit 
number on line 6 of the alter selection screen (Figure 4-7) or entered the 
ALTER = value screen command. 


You use this menu to alter the definition of an existing control unit in the IOCDS in 
storage. When the screen is displayed, it shows the existing information for the 
control unit you have selected to alter. 


On line 5, IOCP displays the control unit number of the control unit you are 
altering. You cannot alter the control unit number itself on this screen. To alter the 
control unit number, delete the existing definition of the control unit from the 
IOCDS in storage and add a new one. 


On lines 6 through 18, IOCP displays the existing control unit information, which 
you can alter by keying in new information to define the control unit. The data that 
you can alter is intensified on the screen. 


If the control unit connects to more than one channel path, enter the additional 
channel path identifiers (chpids) on line 13. If the control unit can recognize sets of 
unit addresses, enter the additional sets on lines 16 through 18. You can specify a 
maximum of eight sets of addresses. 


Press ENTER to add the altered control unit record to the IOCDS in storage. 


Line 

1 1/0 CONFIGURATION PROGRAM 

2 ALTER CONTROL UNIT 

3 

4 ENTER REQUIRED INFORMATION: 

5 CONTROL UNIT NUMBER__(1 TO 3 HEX) ==> 

6 CU TYPE NUMBER (1 TO 5 ALPHA) ==> 

7 CONTROL UNIT SHARED? (Y,YB,N) ==> 

8 PROTOCOL (D,S,S4) ==> 

9 CHPID #1 (2 HEX) ==> 

10 UA SET #1: FROM (2 HEX) ==> 

11 UA SET #1: TO (2 HEX) ==> 

12 ENTER ADDITIONAL CHPID(S): 

13 CHPID#2 => CHPID#3 => CHPID#4 => 
14 ENTER ADDITIONAL UNIT ADDRESS SET(S): 

15 SET FROM TO SET FROM TO SET FROM TO 
16 2 => 3 => 4 => 

17 5 => 6 => 7 => 


8 => 


ADD DISPLAY END 
21 ALTER DELETE MENU 
22 system status 

23 message line 
command line 


RESHOW 


Figure 4-14. Alter Control Unit Screen 
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I/O Device Display 
The screen shown in Figure 4-15 appears when you have entered an I/O device 
number/address on line 5 of the display selection screen (Figure 4-5) or entered the 
DISPLAY = value screen command. 
This screen displays, to the right of the arrows, the data for the requested I/O device. 


The optional information appears only if it was defined for 370-XA mode. 


Enter a screen command and press ENTER to select another menu. 


1/0 CONFIGURATION PROGRAM 


2 1/0 DEVICE DISPLAY 

3 

4 REQUIRED INFORMATION: 

5 DEVICE NUMBER/ADDRESS__(1 TO 3 HEX) ==> 
6 UNIT ADDRESS (2 HEX) ==> 
7 DEVICE TYPE NUMBER__(1 T0 5 ALPHA) ==> 
8 DEVICE TYPE MODEL___(1 TO 2 ALPHA) ==> 
) CONTROL UNIT NUMBER _(1 TO 3 HEX) ==> 
10 TIMEOUT? (Y,N) ==> 
11 OPTIONAL INFORMATION: 

12 PREFERRED PATH (2 HEX) ==> 
13 : 

14 ADDITIONAL CONTROL UNIT NO(S): 


15 CU NO#2 => CU NO#3 => CU NO#4 => 


20 ADD DISPLAY END RESHOW 
21 ALTER DELETE MENU 

22 system status 

23 message line 
command line 


Figure 4-15. 1/O Device Display Screen 
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Add t/O Device aT 

The screen shown in Figure 4-16 appears when you have entered an I/O device 
address/number on line 5 of the add selection screen (Figure 4-6) or entered the 
ADD = value screen command. 


You use this menu to add an I/O device or set of I/O devices to the IOCDS in 
storage. Before adding an I/O device or set of I/O devices, you must add the control 
unit(s) to which the I/O device(s) are assigned. 


On line 5, IOCP displays the device address/number of the I/O device you are 
adding. 


On lines 6 through 18, key in the I/O device information for the I/O device(s) that 
you want to add. To add more than one I/O device, key in the ending address of 
the added devices on line 18. For example, if you have selected to add device 210 
(which appears on line 5) and want to add a set of devices with addresses 210 
through 21F; then key in IF on line 18. 


Specify the optional information (preferred path) only for a device used in 370-XA 
mode. 


Press ENTER to add the I/O device record(s) to the IOCDS in storage. 


i! 1/0 CONFIGURATION PROGRAM 

2 ADD 1/0 DEVICE 

3 

4 ENTER REQUIRED INFORMATION: 

5 DEVICE NUMBER/ADDRESS__(1 TO 3 HEX) ==> 
6 UNIT ADDRESS (2 HEX) ==> 
7 DEVICE TYPE NUMBER__(1 TO 5 ALPHA) ==> 
8 DEVICE TYPE MODEL (1 TO 2 ALPHA) ==> 
] CONTROL UNIT NUMBER (1 TO 3 HEX) ==> 
10 TIMEOUT? (Y,N) ==> 
di ENTER OPTIONAL INFORMATION: 

12 PREFERRED PATH (2 HEX) ==> 
13 

14 ENTER ADDITIONAL CONTROL UNIT NO(S): 

15 CU NO#2 => CU NO#3 => CU NO#4 => 
16 

17 ENTER - IF ADDING MULTIPLE DEVICES: 

18 LAST UNIT ADDRESS (2 HEX) ==> 
19 
20 ADD DISPLAY END RESHOW 
21 ALTER DELETE MENU 


22 system status 
23 message line 
command line 


Figure 4-16. Add I/O Device Screen 
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Alter I/O Device 


The screen shown in Figure 4-17 appears when you have entered an I/O device 
address on line 7 of the alter selection screen (Figure 4-7) or entered the 
ALTER = value screen command. 


You use this menu to alter the definition of an existing I/O device in the IOCDS in 
storage. When the screen is displayed, it shows the existing information for the I/O 
device you have selected to alter. 


On line 5, IOCP displays the I/O device number/address of the I/O device you are 
altering. You cannot alter the device number/address itself on this screen. To alter 
the device number/address, delete the existing definition of the I/O device from the 
IOCDS in storage and add a new one. 


On lines 6 through 15, IOCP displays the existing I/O device information, which you 
can alter by keying in new information to define the I/O device. The data that you 
can alter is intensified on the screen. 


The optional information appears only if it was defined for 370-XA mode. 


Press ENTER to add the altered I/O device record to the IOCDS in storage. 


1/0 CONFIGURATION PROGRAM 
ALTER 1/0 DEVICE 


ENTER REQUIRED INFORMATION: 
DEVICE NUMBER/ADDRESS__(1 TO 3 HEX) 
UNIT ADDRESS (2 HEX) 
DEVICE TYPE NUMBER___(1 TO 5 ALPHA) 
DEVICE TYPE MODEL____(1 TO 2 ALPHA) 
CONTROL UNIT NUMBER__(1 TO 3 HEX) 
TIMEOUT? (Y,N) 
ENTER OPTIONAL INFORMATION: 
PREFERRED PATH (2 HEX) 


ENTER ADDITIONAL CONTROL UNIT NO(S): 
CU NO#2 =>- CU NO#3 => CU NO#4 => 


ADD DISPLAY END RESHOW 
ALTER DELETE MENU 

system status : 

message line 

command line 


Figure 4-17. Alter I/O Device Screen 
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Build lIOCDS from Cards 


The screen shown in Figure 4-18 appears when you enter menu number 5 on the 
primary menu screen (Figure 4-4). 


You use this menu to read card-image macro instructions from a card reader or 
magnetic tape, to generate an IOCDS in storage, and to produce reports of the 
generated IOCDS. For additional information on this menu, see the topic 
“Replacing an IOCDS by Using Card-Image Input” later in this chapter. 


Note that the input and output devices you specify on this menu must be defined in 
the I/O configuration processed on the previous power-on reset or SYSTIML CLEAR 
and must be available to the processor you are using to execute IOCP. The printer 
must also be initialized (the forms and print buffer must be loaded). While 
executing IOCP, assign exclusively to IOCP any devices and control units that IOCP 
uses. (Other systems should not share the devices and control units.) 


On line 5, key in the device address/number of the input device that is to read the 
card-image input deck. On line 7, key in the type of input device (C for card reader 
or T for magnetic tape). IOCP assumes that the input records have a length of 80 
bytes and a block size of 80 to 32,800 bytes. 


On line 8, key in either Y (yes) to ignore non-IOCP input (for example, when you 
have a combined input deck containing JOCP and system generation macro 
instructions), or N (no) to flag non-IOCP input as errors (for example, when your 
input deck contains only IOCP macro instructions and parameters). 


If the input device is a tape drive: on line 11, key in the number of the physical file 
on the reel (such as 1, 2, or 3) that contains the IOCP input deck. The number on 
line 11 should include any leading tape marks and/or files containing tape labels. 
IOCP will issue a rewind command followed by “n” (where n is one less than the 
number you specify on line 11) forward space file command(s) to position the tape 
to the requested file. 


If the input device is a tape drive: on line 12, key in the appropriate mode set 
command that applies to the tape drive (if other than the default of 03). 


On line 9, key in the device address/number of the printer that is to print IOCP 
messages and reports or, key in NA if you do not have a printer available. If you 
use NA, all IOCP messages and reports are lost. On line 14, key in Y (yes), N (no), 
or NA (not applicable) for blocking printer data checks depending on the 
characteristics of the printer. On line 15, key in the maximum number of lines that 
you want on an output page (you can specify up to 99). The default is 55. ((OCP 
also defaults to 55 if you specify a value less than 11.) 


On lines 16 and 17, respectively, IOCP displays time and date information that will 
appear at the top of each page of the IOCP configuration reports. The time and 
date displayed are either zeroes or values you provided on a previous menu screen. 
You can change the time and/or date displayed by keying in the values you want 
printed on the reports. On line 16, key in the hour and minute values; on line 17, 
key in the year and day values. (Note that the time and date entries you make do 
not activate the time-of-day clock.) 


Press ENTER to build the IOCDS in storage from the card-image input. 
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1 1/0 CONFIGURATION PROGRAM 
2 BUILD IOCDS FROM CARDS 


3 
4 ENTER REQUIRED INFORMATION: 

5 INPUT DEVICE ADDRESS/NUMBER (3 HEX) ==> 
6 INPUT DEVICE TYPE (C=CARD READER) 

7 _-(T=TAPE DRIVE) ==> 
8 IGNORE UNKNOWN CARD STATEMENTS? __(Y,N) ==> 


9 OUTPUT PRINTER ADDR/NUMBER___(3 HEX,NA) ==> 
10 ENTER IF THE "INPUT DEVICE TYPE" IS A TAPE DRIVE: 

11 FILE NUMBER (1 to 2 DECIMAL) ==> 
12 MODE SET CMD (DEFAULT=03 (HEX)) ==> 
13 ENTER IF YOU SPECIFY AN “OUTPUT PRINTER ADDRESS": 

14 BLOCK PRINTER DATA CHECKS? (Y,N,NA) ==> 
15 LINES PER PAGE___(DEFAULT=55 (DECIMAL)) ==> 
16 TIME (HOUR.MINUTE) (HH.MM) ==> 


DATE (YEAR.DAY (JULIAN) ) (YY DDD) 


END 
21 MENU 
22 system status 
23 message line 
command line 


RESHOW 


Figure 4-18. Build IOCDS from Cards Screen 
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Print IOCDS Configuration Reports with Service Aid Facility 
The screen shown in Figure 4-19 appears when you enter menu number 6 on the 
primary menu screen (Figure 4-4). 


You use this menu to produce IOCP configuration reports of the IOCDS that is in 
storage. This menu also allows you to use the service aid facility to swap channel 

path information (reports are also produced when you use the service aid facility). 

See Chapter 5 for examples of [OCP configuration reports. 


Note that the output printer that you specify on this menu must be defined in the 
I/O configuration that was processed on the previous power-on reset or SYSIML 
CLEAR and must be available to the processor you are using to execute IOCP. The 
printer must also be initialized (the forms and print buffer must be loaded). While 
executing IOCP, assign exclusively to IOCP any devices and control units that IOCP 
uses. (Other systems should not share the devices and control units.) 


On line 5, key in the address/number of the printer that is to print the IOCP 
messages and reports. On line 6, key in Y (yes), N (no), or NA (not applicable) for 
blocking printer data checks depending on the characteristics of the printer. On line 
7, key in the maximum number of lines that you want on an output page (you can 
specify up to 99). The default is 55. (IOCP also defaults to 55 lines if you specify a 
value less than 11.) 


On lines 8 and 9, respectively, [OCP displays time and date information that will 
appear at the top of each page of the reports. The time and date displayed are 
either zeroes or values you provided on a previous menu screen. You can change 
the time and/or date displayed by keying in the values you want printed on the 
reports. On line 8, key in the hour and minute values; on line 9, key in the year and 
day values. (Note that the time and date entries you make do not activate the 
time-of-day clock.) 


Note: This menu allows you to obtain reports of an IOCDS in storage that is in 
error. If you use this menu and the IOCDS in storage is in error, IOCP produces 
the reports followed by the appropriate error message describing the first detected 
error (such as one of the messages ICP300I1 through ICP307I). 


Press ENTER to produce the reports of the IOCDS in storage. 


Service Aid Facility 
Lines 12 and 13 are intended for use only by service personnel who are swapping 
(exchanging) cables to isolate channel path, control unit, or I/O device failures. To 
use the service aid facility, the unswapped (original) IOCDS must be in storage. 


Make the required entries on lines 5 through 9. On lines 12 and 13, you enter the 
channel path identifiers (chpids) that identify the cables you want to swap. Note 
that both channel paths must be the same type, either block or byte multiplexer. 


Press ENTER to swap the chpids and print reports. Before printing reports of the 
IOCDS in storage, IOCP will swap the two chpids on every control unit and I/O 
device entry in which they appear. In addition, IOCP also swaps (exchanges) all the 
channel path information between the two entered chpids. 
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The service personnel should review the printed configuration reports to verify the 
correct swapping of the channel paths. If the swapping is correct, use menu 8 
(Figure 4-21) to write the changed (new) IOCDS to one or more IOCDS(s) in the 
processor controller. You must use action A2 on the CONFIG (SYS020) frame to 
activate the new IOCDS. | 


T/0 CONFIGURATION PROGRAM 
PRINT IOCDS CONFIGURATION REPORTS 


ENTER REQUIRED INFORMATION: 
OUTPUT PRINTER ADDRESS/NUMBER__ (3 HEX) 
BLOCK PRINTER DATA CHECKS? _(Y,N,NA) 
LINES PER PAGE__ DEFAULT=55 (DECIMAL) ) 
TIME (HOUR.MINUTE) (HH .MM) 
DATE (YEAR.DAY (JULIAN) ) (YY .DDD) 


ENTER IF USING SERVICE AID FACILITY: 
CHPID #1 (SWAP WITH CHPID #2) (2 HEX) 
CHPID #2 (SWAP WITH CHPID #1) (2 HEX) 


END RESHOW 
MENU 

system status 

message line 

command line 


Figure 4-19. Print IOCDS Configuration Reports Screen 
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Read IOCDS from the Processor Controller File 
The screen shown in Figure 4-20 appears when you enter menu number 7 on the 
primary menu screen (Figure 4-4). 


You use this menu to read an IOCDS from the processor controller into the IOCDS 
storage area. 


On line 5, key in the level of the IOCDS. You can enter only one value. The valid 
entries depend on the number of I/O configuration data sets that your processor 
complex supports: 


¢ For two I/O configuration data sets, the valid entries are 0, AO, 1, and Al. 


¢ For four I/O configuration data sets, the valid entries on the A side are 0, 1, AO, 
Al, A2, and A3; on the B side they are 0, 1, BO, Bl, B2, and B3. 


¢ For eight I/O configuration data sets, all of the entries are valid on a 3084 
Processor Complex operating in MP mode. 


Note: The value 0 is the same as AQ; | is the same as Al. 


Press ENTER to read the selected data set into storage. (After the read operation is 
completed, you can use menu 8 to display MSG1 and MSG2 of the IOCDS read 
into storage.) You can now add, alter, display, and delete configuration data from 
the IOCDS in storage; you can also obtain reports of the IOCDS in storage. 


On line 11, IOCP displays the status of the read operation. After you press ENTER 
and IOCP begins read processing, the text on line 11 varies between NO 
READ/WRITE IN PROGRESS and READ/WRITE IN PROGRESS FOR 
SECTOR nnnn (where nnnn is the first sector of a group of seven sectors being 
processed). 
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4-28 


1/0 CONFIGURATION PROGRAM 
READ IOCDS FROM THE PROCESSOR CONTROLLER FILE 


ENTER REQUIRED INFORMATION: 
IOCDS TO BE READ (0,1,A0-A3,BO0-B3) ==> 


IOCDS READ/WRITE STATUS: 
NO READ/WRITE IN PROGRESS. see text 
READ/WRITE IN PROGRESS FOR SECTOR nnnn 


END RESHOW 
MENU 

system status 

message line 

command line 


4-20. Read IOCDS from the Processor Controller File Screen 
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Write IOCDS to the Processor Controller File 
The screen shown in Figure 4-21 appears when you enter menu number 8 on the 
primary menu (Figure 4-4) or enter the WRITE screen command. 


You use this menu to write the IOCDS in storage to one or more IOCDS(s) in the 
processor controller. The new configuration can become the active IOCDS if it is 
selected on a following power-on reset or on the next SYSIML CLEAR. 


If you do not want to write the IOCDS in storage to any IOCDS at this time, key in 
N on line 5 and press ENTER. N returns you to the primary menu. (Use N to exit 
from this frame after reviewing/altering MSGI and/or MSG2 without writing the 
IOCDS to the processor controller.) 


On line 5, key in the level of the IOCDS to which you want IOCP to write the 
IOCDS in storage. The valid entries depend on the number of I/O configuration 
data sets that your processor complex supports: 


¢ For two I/O configuration data sets, the valid entries are Y, Al, and N. 


¢ For four I/O configuration data sets, the valid entries on the A side are Y, N, 
AO, Al, A2, and A3; on the B side they are N, BO, B1, B2, and B3. 


e For eight I/O configuration data sets, all of the entries are valid for a 3084 
Processor Complex operating in MP mode. In addition, you can specify ABx 
(where x is 0, 1, 2, or 3) to write the IOCDS in storage to the specified IOCDS 
on both side A and side B. 


Notes: 
1. Specifying Y is the same as specifying Al. 


2. If your processor complex has only a LVLO and LVLI IOCDS, IOCP writes the 
IOCDS from storage to the LVL1 IOCDS. Test the new configuration in the 
LVL1 IOCDS; then switch the LVL1 IOCDS with the LVLO IOCDS. 


On lines 6 and 7, respectively, IOCP displays the time and date that will be used to 
time stamp the IOCDS when it is written to the processor controller. (The time 
stamp will be used on the IOCP configuration reports of this IOCDS to indicate 
when it was written.) The time and date displayed are either zeroes or values you 
provided on a previous menu screen. You can change these values: on line 6, key in 
the hour and minute values; on line 7, key in the year and day values. (Note that 
the time and date entries you make do not activate the time-of-day clock.) 


If you want to write to an IOCDS that is write-protected, you must first remove the 
write-protection using the IOCDSM (SYS021) frame. Then press ENTER to write 
the IOCDS in storage to an IOCDS in the processor controller. 


On line 11, IOCP displays the status of the write operation. After you press ENTER 
and IOCP begins write processing, the text on line 11 varies between NO 
READ/WRITE IN PROGRESS and READ/WRITE IN PROGRESS FOR 
SECTOR nnnn (where nnnn is the first sector of a group of seven sectors being 
processed). 
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On line 15, IOCP displays the contents of MSG1. This information appears on the 
ID1 line in the heading of the configuration reports. Bytes | through 8 are also the 
source of the customer name (dsname) for the IOCDS that appears on the IOCDSM 
(SYS021) frame. On line 16, IOCP displays the contents of MSG2. This 
information appears on the ID2 line in the heading of the configuration reports. 
MSGI and MSG2 can be modified before writing the IOCDS to the processor 
controller. 


Any aphabetie characters entered will appear in upper case in the display even if the 
user entered those characters i in lower case. 


Note: If you write a new IOCDS to the processor seraieoice there might be an 
inconsistency between the system configuration created by a system generation and 
the I/O configuration in the new IOCDS. 


I/0 CONFIGURATION PROGRAM 
WRITE IOCDS TO THE PROCESSOR CONTROLLER FILE 


ENTER REQUIRED INFORMATION: 
WRITE IOCDS___(Y,N,A0-A3, BO- B3 , ABO- 183) 
TIME (HOUR. MINUTE) (HH .MM) 
DATE (YEAR.DAY (JULIAN) ) (YY.DDD) 


IOCDS READ/WRITE STATUS: | 
NO READ/WRITE IN PROGRESS. see text 
READ/WRITE IN PROGRESS FOR SECTOR nnnn 


ENTER CHANGES FOR MSG1.AND/OR MSG2: 
NOTE: -DSNAME- IS THE FIRST EIGHT BYTES OF MSG1. 
MSG1 ==> oo 
MSG2 ==> 


END RESHOW 
MENU 

system status 

message line 

command line 


Figure 4-21. Write IOCDS to the Processor Controller File Screen 
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End lOCP 


The screen shown in Figure 4-22 appears when you enter END on line 24 of a menu 
screen and the IOCDS in storage has been generated or modified but has not been 
written to any IOCDS in the processor controller. 


You use this menu to terminate IOCP and confirm the destruction of the IOCDS in 
storage (END), continue IOCP operation (MENU), or select the write I[OCDS to the 
processor controller file menu (WRITE). 


On line 24, key in END, MENU, or WRITE. 
Press ENTER. 


If you keyed in END and the audible alarm sounds, put the console into FDC 
mode. Then type RSTALM on the command line and press ENTER to reset the 
alarm. -e : . 


1/0 CONFIGURATION PROGRAM 
END IOCP 


HK KK KK KKK IK KKK KKK KIRKE EER EKE ERE 


* ATTENTION: THE IOCDS IN STORAGE HAS * 
* BEEN MODIFIED OR GENERATED BUT NOT * 
* WRITTEN TO THE PROCESSOR CONTROLLER * 
* FILE. Se . 


KKERKKRERERREKRRKEERKEEREREEREREKREREKEERERREEKKER 


SELECT COMMAND AND ENTER ON BOTTOM LINE: 


__ TO DESTROY THE IOCDS IN STORAGE, ENTER END. 
_. TO CONTINUE WITH IOCP OPERATION, ENTER MENU. © 
__ TO BRING UP THE WRITE IOCDS MENU, ENTER WRITE. 


END RESHOW 
MENU WRITE 
system status 
message line 
command line 


4-22. End IOCP Screen 
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Methods of Executing the Stand-Alone Version of IOCP 


This topic suggests steps that can be used to execute the stand-alone version of IOCP 
in order to (1) generate an IOCDS during the installation of a new processor 
complex by the customer engineer (CE), and (2) replace an IOCDS by using 
card-image input on an existing processor complex. 


Generating an IOCDS on a New Processor Complex 
Note: The steps in this example are performed by the customer engineer (CE) as 
part of the installation procedure for a processor complex. This example assumes 
that the installation has previously prepared the card-image input macro instructions 
for use by the CE. This input deck should define the initial I/O configuration for 
the new processor complex and can consist of IOCP macro instructions only or 
IOCP macro instructions combined with MVS system generation macro instructions. 


During the installation of a new processor complex, the CE needs to create at least a 
minimum IOCDS before generating the complete IOCDS from card-image input 
macro instructions. This minimum IOCDS consists of an input device (card reader 
or magnetic tape) to read the installation-prepared input macro instructions and an 
output printer to receive messages and reports. (You can execute IOCP without an 
output printer; however, all IOCP: messages and reports are lost.) 


By using the appropriate console commands and IOCP menus, the CE follows these 
steps to generate an IOCDS for the new processor complex. 


1. Determine the addresses and characteristics of the.installed channel path(s), 
control unit(s), and I/O devices to be used as the input and output devices 
needed for the minimum IOCDS. 


Note: The starter configuration (shipped as an IOCDS in the processor 
controller) might have defined the needed devices, in which case Steps 2 through 
7 can be skipped. Compare the configuration reports provided for the starter 
configuration with the physically installed devices. 


2. Start IOCP from the system console or the service support console. When you 
start IOCP, IOCP initializes a null IOCDS in storage. 


3. Add the definitions of the channel path(s), control unit(s), and I/O devices 
needed to read the input deck and print messages and reports. (See Figure 4-6, 
Figure 4-10, Figure 4-13, and Figure 4-16.) , 


4. Display the channel path(s), control unit(s), and I/O devices you added in Step 3 
to ensure they are correctly defined. (See Figure 4-5, Figure 4-9, Figure 4-12, 
and Figure 4-15.) 


5. Write the IOCDS in storage to one or more IOCDS(s) in the processor 
controller. (See Figure 4-21.) 


6. End IOCP. (See Figure 4-22.) 


7. Perform a power-on reset of the system with the appropriate IOCDS as the 
source of the configuration data to be used by the channel subsystem. Use the 
IOCDSM (SYS021) frame to select the IOCDS and the CONFIG (SYS020) 
frame to perform the power-on reset. The channel subsystem can now perform 
I/O requests to the needed input and output devices. 


_8. Prepare the input device with the installation-prepared input deck. 


9. Prepare the output printer. Note that the printer buffer must have been 
previously initialized before JOCP can print to it. 
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[2. 


. Start IOCP. 
. Build an IOCDS from card-image input. (See Figure 4-18.) If the input deck 


contains MVS system generation macro instructions, use the IGNORE= Y 
option on the build IOCDS from cards menu. (For more details, see “Steps 
IOCP Performs to Build an IOCDS”, in this chapter.) 


Analyze the configuration reports produced in Step 11 to ensure that the 
generated IOCDS in storage matches the installation’s I/O configuration plan. 
If it does not, consult with the installation’s system programmer. 


. Write the IOCDS generated in storage in Step 11 to one or more IOCDS(s) in 


the processor controller. (See Figure 4-21.) 


. End IOCP. 
. If your processor complex only has a level AO and Al (LVLO and LVL1) 


IOCDS, switch the the data sets after the new I/O configuration has been tested. 


To switch data sets, use action 3 (SWITCH DS A/B) on the CONFIG (SYS020) 


20. 


rae 
Dae 


frame. The AO IOCDS now contains the installation’s initial IOCDS. The Al 
IOCDS contains the starter configuration. 


. Perform a power-on reset of the system and use the appropriate IOCDS as the 


source of configuration data. 


. Start IOCP. 
. Read the active IOCDS into storage. (See Figure 4-20.) 
. Produce reports of the IOCDS in storage. (See Figure 4-19.) These 


configuration reports represent the active I/O configuration for the processor 
complex. 


Return the input deck to the installation’s system programmer. The deck is used 
by the installation on subsequent definitions of an IOCDS based on changes to 
the I/O configuration. 


End IOCP. 


Continue with the installation of the new processor complex. This includes 
testing the I/O subsystem using the I/O configuration defined by the installation. 


Replacing an IOCDS by Using Card-Image Input 
This example describes the steps the installation can use to replace the I/O 
configuration data in an IOCDS on an installed processor complex. (For an MVS 
system, you can also use the MVS version of IOCP. See “Subsequent Definition and 
Replacement of I/O Configuration Data” in Chapter 2 for the required steps. Fora 
VM/SP, VM/SP HPO, or VM/XA Systems Facility system, you can also use the VM 
version of IOCP. See “Subsequent Definition and Replacement of I/O 
Configuration Data” in Chapter 3 for the required steps.) The following procedure 
describes how to use the stand-alone version of IOCP to change the I/O 
configuration for your processor complex. 


I, 


Update your input deck to reflect the new I/O configuration for your processor 
complex. This deck can consist of IOCP macro instructions only or IOCP 
macro instructions combined with MVS system generation macro instructions. 


. Start IOCP from the system console. 
. Prepare the input device with the new input deck. 


. Prepare the printer. The printer must be initialized (the forms and print buffer 


must be loaded). 
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10. 


EI, 


13. 


. On the primary menu (Figure 4-4), enter menu number 5 to select the build 


IOCDS from cards menu (Figure 4-18). 


. Key in the appropriate data and press ENTER. | 


IOCP reads, checks the syntax, and validates the input macro instructions; it 
generates an IOCDS in storage; and it produces configuration reports of the 
IOCDS generated in storage. (For more details, see “Steps IOCP Performs to 
Build An IOCDS” in this chapter.) 


. Analyze the configuration reports produced in Step 6 to ensure that the desired 


I/O configuration has been generated. 


. If the input deck needs to be changed: end IOCP, modify the input deck, and 


start again at Step 2. 


. If the input deck is correct: return to the primary menu, select the write IOCDS 


to the processor controller file menu (Figure 4-21), and write the generated 
IOCDS to the level xx IOCDS in the processor controller. 


End IOCP. 


The I/O configuration data in the level xx IOCDS now contains your new 
configuration. On a following power-on reset, you activate this new 
configuration by selecting the level xx IOCDS as the source of the configuration 
data the channel subsystem uses to control I/O requests. Use the IOCDSM 
(SYS021) frame to select the IOCDS and the CONFIG (SYS020) frame to 
perform a power-on reset. . 


Test the new configuration following the procedures established for your 
installation. 


. If your processor complex has only a level AO and Al (LVLO and LVL1) 


IOCDS, switch the data sets after the new I/O configuration has been tested. To 
switch data sets, use action 3 (SWITCH DS A/B) on the CONFIG (SYS020) 
frame. This action places the new I/O configuration in the AO IOCDS. (The Al 
IOCDS contains the configuration previously defined in the AO IOCDS.) Before 
the next power-on reset, specify the AO IOCDS as the source of configuration 
data for the channel subsystem. 


Save the card-image input used in Step 5 to provide a backup. 


Notes: 


1. 


For an MVS system, if you change the hardware configuration with the 
stand-alone version of IOCP, execute an MVS system generation with an input 
deck modified to reflect the changes. This action ensures consistency between 
the software and hardware configurations. 


. For a VM/SP, VM/SP HPO, or VM/XA Systems Facility system, if you change 


the hardware configuration with the stand-alone version of IOCP, modify the 
real I/O configuration file and re-generate your operating system. This action 
ensures consistency between the software and hardware configurations. (The real 
I/O configuration file for VM/SP and VM/SP HPO is DMKRIO; for the 
VM/XA Systems Facility, it is HCPRIO.) 


IOCP User’s Guide and Reference 


Steps [OCP Performs to Build an IOCDS 


IOCP performs the following steps when you specify that you want to generate an 
IOCDS. 


Note: Steps 1 through 5 are repeated for each input macro instruction as it is read 
(unless an error is found as indicated in Steps 3 and 4). 


IOCP: 


Li 
2 
3% 


Reads each macro instruction from the input device. 
Prints each macro instruction on the output printer. 


Checks the syntax of each macro instruction for correct format. If a syntax 
error is found (such as a missing parenthesis), IOCP prints an error message on 
the output printer following the macro instruction that contains the error. IOCP 
stops checking the syntax of a macro instruction when it encounters the first 
syntax error on that macro instruction. Therefore, if there are two or more 
syntax errors on a single macro instruction, the second and following errors are 
found on subsequent runs of LOCP. 


If IOCP finds an error in Step 3, [OCP returns to Step | and continues reading, 
printing, and checking the syntax of the following macro instructions, but does 
not perform any of the following steps. 


. Checks the validity of each macro instruction. For example, IOCP checks that a 


CNTLUNIT macro instruction has specified a channel path that has been 
previously defined on a CHPID macro instruction. If an error is found, IOCP 
prints an error message on the output printer following the macro instruction 
that contains the error. 


If IOCP finds an error in Step 4, IOCP returns to Step 1 and performs only 
Steps 1 through 3 for the remainder of the macro instructions. Therefore, if 
there are two or more validity errors in your input deck, the second and 
following errors are found on subsequent runs of IOCP. 


. Builds the appropriate identification, channel path, control unit, or I/O device 


record and enters the record into the IOCDS in storage. 


If more macro instructions remain to be read, IOCP returns to Step 1. 


After all of the input macro instructions have been processed and all of the records 
entered into the IOCDS in storage, IOCP performs Step 6. 


6. Generates the IOCDS in storage and makes additional checks. For example, 


IOCP checks that the channel numbers within a channel set are consecutive. If 
JOCP finds an error, IOCP issues an error message and waits for the next 
command. 


After IOCP has successfully generated an IOCDS in storage, IOCP performs Step 7. 


7. Produces the IOCP configuration reports of the IOCDS generated in storage. 


After checking the configuration reports to ensure that the correct configuration 
was generated, you can write the IOCDS generated in storage to one or more 
IOCDS(s) in the processor controller. (See Figure 4-21.) 
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Dumping lOCP Storage 
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To help you debug IOCP problems, the stand-alone version of [OCP provides a 
dump function that allows you to dump the IOCP storage area (including the 
IOCDS in storage) to a printer or tape drive. Note that the dump routine has no 
I/O recovery procedures. 


To invoke the dump function, perform the following steps: 
1. Prepare the output device: | 


¢ If the output device is a printer, make the printer ready. (JOCP uses 
LRECL = 120) 


¢ If the output device is a tape drive: mount an unlabeled tape, rewind the 
tape to the load point, and make the tape drive ready. (IOCP uses 
LRECL = 121 and RECFM = FA.) 


Note that the output device must be defined in the I/O configuration that was 
processed on the previous power-on reset or SYSIML CLEAR and must be 
available to the processor you are using to execute IOCP. While executing 
IOCP, assign exclusively to IOCP any devices and control units that IOCP uses. 
(Other systems should not share the devices and control units.) 


2. With the console in frame dependent command (FDC) mode, key in SYSRESET 
and press ENTER. (To put the console in FDC mode: key in FDC, press and 
hold down the ALT key, and press the CMD key while holding down the ALT 
key.) 


3. Key in F ALTCPn (or F CP-n20). 
Replace n with the processor you are using to execute IOCP: enter 0, 1, 2, or 3. 
Press ENTER. 


4. When system frame ALTCPn (CP-n20) is displayed, key in an appropriate 
option as indicated on the frame, and press ENTER to display the floating point 
registers. 


Alter floating point register 0 as follows: 


e Ifthe output device is a printer, set the three rightmost hexadecimal digits to 
the device address/number of the printer. Set all other digits to 0. 


e If the output device is a tape drive, set the three rightmost hexadecimal 
digits to the device address/number of the tape drive. Set the two leftmost 
hexadecimal digits to the hexadecimal value of the tape mode set command. 
(To use reset mode, use a value of 03.) Set all other digits to 0. 


Press ENTER. Ensure that the contents of the register were correctly altered. 


5. Key in an appropriate option as indicated on the frame, and press ENTER to 
display the current PSW. 


Alter the PSW to: 000COQ0000000F FC. 
Press ENTER. Ensure that the contents of the PSW were correctly altered. 
6. Key in START CPn. 
Replace n with the processor you are using to execute IOCP: enter 0, 1, 2, or 3. 


Press ENTER. A dump is taken of the IOCP storage area and IOCDS in 
storage. 
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When the dump has completed, IOCP loads a disabled PSW with a wait state code 
of B20 and issues message ICP515W to the console. If the audible alarm sounds 
when IOCP enters the disabled wait state, type RSTALM on the bottom line and 
press ENTER to reset the alarm. 


In 370-XA mode, a wait state code of B23 occurs if [OCP was unable to match the 
device number in floating point register 0 with a subchannel information block. You 
must enter a device number in floating point register 0 that is defined in the active 
IOCDS (the IOCDS used in the previous power-on reset or SYSIML CLEAR). 
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lIOCP Wait State Codes 


Enabled Wait States 


During execution of the stand-alone version of IOCP, the processor enters many 
enabled (PSW Bit 7 is on) wait states. These are normal conditions while IOCP 
waits for the processor controller to respond to IOCP requests such as a read or 
write to a console or IOCDS. If the processor stays in an enabled wait state, other 
than waiting for operator input on a console, for an extended period of time (1 - 3 
minutes), the processor controller is busy. The user may either wait for the 
processor controller to finish or put the console in to FDC mode, do a SYSRESET 
to the processor running IOCP and restart IOCP at a later time. If the problem 
persists take an IOCP dump and contact IBM for programming support. 


Disabled Wait States 


During execution of the stand-alone version of IOCP, IOCP issues the following wait 
state codes when the indicated conditions occur. (Note that the MVS and VM 
versions of IOCP do not issue wait state codes.) 


If the audible alarm sounds when IOCP enters the disabled wait state, put the 
console into FDC mode (if it isn’t already). Then type RSTALM on the bottom line 
and press ENTER to reset the alarm. 


B20 


Explanation: The console operator who is 
executing the stand-alone version of IOCP has 
ended IOCP processing, or the IOCP dump 
function has been completed. 


Operator Response: None. 


B21 


Explanation: A program check interruption has 
occurred during execution of the stand-alone 
version of IOCP. 


Operator Response: Notify your system 
programmer. 


Problem Determination: Save all associated output. 


Take an IOCP dump. Contact IBM for 
programming support. 


B22 


Explanation: A machine check interruption has 
occurred during execution of the stand-alone 
version of IOCP. 


Operator Response: Notify your system 
programmer. 


Problem Determination: Save all associated output. 


Contact IBM for hardware support. 
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B23 


Explanation: (1) An uncorrectable I/O error has 
occurred during execution of the stand-alone 
version of IOCP. (2) The user requested a dump of 
IOCP storage in 370-XA mode, but IOCP was 
unable to find a subchannel information block for 
the device number entered in floating point register 
0. 


Operator Response: (1) Notify your system 
programmer. (2) Enter the correct device number 
in floating point register 0 and try the IOCP dump 
procedure again. 


Problem Determination: (1) Save all associated 
output. Take an IOCP dump. Contact IBM for 
hardware support. (2) None. 


B24 


Explanation: During execution of the stand-alone 
version of IOCP, IOCP has encountered an error in 
the processor controller and cannot communicate 
with the person operating IOCP. 


Operator Response: Notify your system 
programmer. 


Problem Determination: Save all associated output. 
Take an IOCP dump. Contact IBM for hardware 
support. 
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This chapter describes the [OCP configuration reports. You use the reports to check 
the I/O configuration data in an IOCDS. Following is a brief description of each 
configuration report with references to report examples: 


¢ The channel path identifier (CHPID) summary report lists the channel path 
identifiers defined in the LOCDS. For each channel path identifier, the report 
shows the corresponding channel number, the channel set, and the mode of I/O 
operation. Figure 5S-] is an example of the CHPID summary report. 


If you do not enter a 370 channel number and channel set, N/A appears in those 
columns in the report. 


¢ The I/O device report lists, by 370-XA device number, the I/O devices defined in 
the IOCDS. The report shows the siae (side A if the chpid is less than 40, 
otherwise. side B), control units, and channel path identifiers to which each 
device is assigned. The report also provides other information, such as 
subchannel assignment (shared, shared block, or nonshared subchannel.) 
Figure 5-2 consists of pages from an I/O device report. 


If you do not enter a 370 channel number (370 CHANNEL ADDR on the 
report) and channel set, N/A appears in those columns in the report. Ifa 
370/370-XA IOCP reads a 370 IOCDS, N/A appears in the report under 370-XA 
SUB-CHAN NUMBER and 370-XA LOG CNTL UNIT NUMBER. 


If applicable, the I/O device report lists warning message ICPOS4I (the I/O 
device is not connected to the specified primary channel address). 


¢ The logical control unit report lists the 370-XA logical control units in the 
IOCDS by logical control unit number. For each logical control unit, the report 
lists the rotation order for 370-XA mode (under DEVICE CHPID ORDER). 
For each device in a logical control unit, the report shows the device number, 
the attaching control units, and the preferred channel path. Figure 5-3 consists 
of pages from the logical control unit report. 


Note: Logical control units with no devices are listed at the end of the logical 
control unit report. The user should verify that the logical control unit report 
accurately describes the user’s configuration. 


A logical control unit report is not produced if IOCP (370 or 370/370-XA) reads 
and prints a 370 IOCDS, or if the IOCDS in storage contains an error. 


If you operate your system only in 370 mode, you can disregard the logical 
control unit report. 


¢ The channel path identifier (CHPID) report, like the CHPID summary report. 
lists the channel path identifiers defined in the IOCDS. In addition to the 
information given in the CHPID summary report (Figure 5-1), the CHPID 
report shows the side the channel path is assigned to for 370 mode, and the 
control units and I/O devices assigned to each channel path. It also provides 
other information, such as the interface protocol (D. C. interlock or data 
streaming) used by the control unit(s) attached to the channel path. Figure 5-4 
consists of pages from the channel path identifier report. 


If you do not enter a 370 channel number and channel set, N/A appears in those 
columns in the report. If a 370/370-XA IOCP reads and prints a 370 IOCDS, 
N/A appears in the report under 370-XA LOG CNTL UNIT NUMBER. 
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Notes: 


1. A 370 level IOCP cannot read a 370/370-XA IOCDS. (IOCP issues error 
message ICP404I and does not print reports.) . 


2. The Device Configuration Frame (DEVCXA) provides real-time device 


configuration data for 370-XA mode operation. For each subchannel number, 
the DEVCXA frame displays the corresponding device number, unit address, 
and attaching channel path identifiers. You can minimize requesting IOCP 
configuration reports by. using the DEVCXA frame. 


Conditions for Producing Reports | 
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If no error occurs, the MVS version of IOCP Bigeodees reports when: 


¢ IOCP generates an IOCDS. ..The-reports show the configuration data in the 
IOCDS that is generated in storage based on the input macro instructions. 


¢ You code the REPORT option on the PARM parameter of the EXEC 
statement. The reports show the configuration data contained in each IOCDS 
that you specified on REPORT =. 


If no error occurs, the VM version of IOCP produces reports when: 


¢ IOCP generates an IOCDS in response to the CMS IOCP command with 
IOCDS generation options. The reports show the configuration data in the 
IOCDS that IOCP generates in storage from the input macro instructions. 


* You use configuration report options (BOTHRPT, CDORPT, CDIRPT, 
RPTAx, RPTBx, RPTA, or RPTB) on the CMS IOCP command. The reports 
show the configuration data contained in each specified IOCDS. 


If no error occurs, the stand-alone version of IOCP produces reports, when 


¢ You use the build IOCDS from cards menu (Figure 4-18). The reports show the 
configuration data in the IOCDS that i is generated in storage based on the input 
macro instructions. 


° You use the print IOCDS configuration reports menu (Figure 4-19). The 
reports show the configuration data contained in the IOCDS in storage. In this 
case, the configuration data represents one of the. following: 


— The IOCDS that has been previously read into storage using the read from 
the processor controller file menu (Figure 4-20) 


— The IOCDS that has been previously generated in storage from card-image 
input using the build IOCDS from cards menu (Figure 4-18) 


— The IOCDS in storage after starting IOCP and adding configuration data to 
the null IOCDS from the console screen | 


Note: If the IOCDS in storage contains an error and you use the print IOCDS 
configuration reports menu, IOCP produces the reports (except the logical 

control unit report), followed by the appropriate error message describing the 
first detected error (such as one of the messages [CP300I through ICP307I). In 
addition, if the IOCDS in storage contains an error, N/A appears in the reports 
for the subchannel numbers and the logical control unit numbers. 


[OCP User’s Guide and Reference 


Configuration Report Headings 
There are four heading lines for each configuration report. The first line of the 
heading shows: 


¢ The time and date IOCP produced the reports! 
¢ The IOCP version and level number. The versions are: 
— Version | is a 370 IOCP. 


— Version 2 is a 370/370-XA IOCP that supports only the LVLO and LVLI 
IOCDS. 


— Version 3 is a 370/370-XA IOCP that supports four I/O configuration data 
sets on each side of the processor complex 


¢ The type of configuration report (CHPID, DEVICE, LOGICAL CONTROL 
UNIT, or CHANNEL PATH ID) 


¢ The report page number 


The second line of the heading shows: 


¢ The report’s source, which can be card input, an IOCDS from a processor 
controller, or screen input 


¢ Whether the IOCDS in storage was modified by screen input. YES indicates 
that either the I[OCDS was originally created from screen input or was modified 
by screen input after being generated from card input. NO indicates the IOCDS 
was generated from card input and was not modified by screen input. 


e When the report source is an IOCDS from a processor controller, if it is the 
active IOCDS: where YES indicates the data set was the active data set at the 
last power-on reset or SYSIML CLEAR, NO indicates the data set was not 
active at the last power-on reset or SYSIML CLEAR, and NA indicates not 
applicable (for a report source of card or screen input) 


¢ When the report source is the active [OCDS, if it was updated: where YES 
indicates the active data set was updated (written to) after the last power-on 
reset or SYSIML CLEAR, NO indicates the active data set was not updated 
(not written to) after the last power-on reset or SYSIML CLEAR, and NA 
indicates not applicable (for a report source of card or screen input) 


The third line of the heading (ID1 =) shows: 


e¢ Any identification information that you specified on the ID macro instruction. 
(Bytes 1 through 8 of [D1 = are the same as the customer name of the IOCDS 
that appears on the IOCDSM (SYS021) frame.) 


¢ When the report source is an IOCDS from a processor controller, the time and 
date IOCP last wrote the IOCDS from storage to the processor controller.? 


1 The MVS and VM versions of IOCP take the time and date from the operating system; the stand-alone version 
takes the time and date entered on the menu screens. 


2 The MVS and VM versions of IOCP take the time and date from the operating system; the stand-alone version 
takes the time and date entered on the menu screens. 
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The fourth line of the heading (ID2=) shows: 


e¢ When the report source is an IOCDS from the processor controller, the 
processor controller time stamp. (The processor controller time stamp also © 
appears on the IOCDSM (SYS021) frame.) 


e Any additional identification information that you specified on the ID macro 
instruction. } 


Note: Figure 5-2, Figure 5-3, and Figure 5-4 contain only representative pages 
from the configuration reports; they do not show every page of every report. 


3 Time stamp information appears if the IOCDS was timestamped when the IOCDS was written to the processor 
controller. 
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IDI=PRACTICE IOCP GENERATION 


ID2=SAMPLE CONFIGURATION WITH THREE BYTE CHANNELS 


IOCP VERSION 3 


LEVEL 2 CHPID REPORT 


REPORT SOURCE IS LVL Ai IOCDS, MODIFIED BY SCREEN INPUT=NO, ACTIVE=NO, UPDATED=NO 


%¥**** CHANNEL PATH IDENTIFICATI 


CHPID 


CHANNEL 


NUMBER 


0 
6 
1 
2 
3 
4 
5 
7 
5 
6 
7 
8 
9 
A 
B 
c 
8 
9 
A 
B 
1 
2 
3 
4 


CHANN 
SET 


PRR RONDO OKR ERR HHH HOD OOOO OO 


E 


ON SUMMARY *XXx 
L 
MODE 


BYTE 

BLOCK 
BLOCK 
BLOCK 
BLOCK 
BLOCK 
BLOCK 
BLOCK 
BLOCK 
BLOCK 
BLOCK 
BLOCK 
BLOCK 
BLOCK 
BLOCK 
BLOCK 
BLOCK 
BLOCK 
BLOCK 
BLOCK 
BLOCK 
BLOCK 
BLOCK 
BLOCK 


in 
i 
J 


Prrrrrrrrrrrrrrrrrrrrrrr 


WRITTEN TO PROCESSOR CONTROLLER ON: TIME 14.50 
PROCESSOR CONTROLLER TIMESTAMP: TIME 14.50 
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TIME 14.52 DATE 85.246 IOCP VERSION 3 LEVEL 2 DEVICE REPORT PAGE 001 


REPORT SOURCE IS LVL Al IOCDS, MODIFIED BY SCREEN INPUT=NO, ACTIVE=NO, UPDATED=NO 


| IDI=PRACTICE IOCP GENERATION WRITTEN TO PROCESSOR CONTROLLER ON: TIME 14.50 BATE 85.246 
{ ID2=SAMPLE CONFIGURATION WITH THREE BYTE CHANNELS PROCESSOR CONTROLLER TIMESTAMP: TIME 14.50 DATE 85.246 


370-XA 370-XA -370-XA LOG. 370~XA 370 370 
DEVICE UNIT SUB-CHAN CNTL UNIT NTL UNIT DEVICE CNTL UNIT CHAN PATH IDS CHANNEL SUB-CHAN 
NUMBER ADDR _NUMBER NUMBER __IYPE ss LTYPE MODEL TIMEQUT _NUMBER ProtocoL |_{_|__|__| SIDE SET ADDR. ASSIGNED 


002 02 000 00 2 3211 YES 001 DCI 00 A 0 002 UNSHARED 
004 04 001 01 2 3211 YES 002 DCI 00 A 0 004  UNSHARED 
012 12 002 02 2 3505 YES 003 DCI 00 A 0 012  UNSHARED 
013 13 003 02 2 3525 YES 003 DCI 00 A 0 013  UNSHARED 
04D 4D 004 03 2 BSC1 YES 004 DCI 00 A 0 04D. UNSHARED 
04E 4E 005 03 2 BSC1 YES 004 DCI 00 A 0 046 UNSHARED 
04F 4F 006 03 2 BSC1 YES 004 DCI 00 A 0 O4F UNSHARED 
050 50 007 03 2 BSC1 YES 004 DCI 00 A 0 050 UNSHARED 
051 51 008 03 2 BSCl YES 004 DCI 00 A 0 051 UNSHARED 
052 52 009 03 2 BSC1 YES 004 DCI 00 A 0 052 UNSHARED 
053 53 00A 03 2 BSC1 YES 004 DCI 00 A 0 053  UNSHARED 
054 54 00B 03 2 BSC1 YES 004 DCI 00 A 0 054 UNSHARED 
055 55 00c 03 2 BSC1 YES 004 DCI 00 A 0 055 UNSHARED 
056 56 00D 03 2 BSC1 YES 004 DCI 90 A 0 . 056 UNSHARED 
057 57 O0E 03 2 BSCl YES 004 DCI 00 A 0 057  UNSHARED 
058 58 00F 03 2 BSCl YES 004 DCI 00 A 0 058 UNSHARED 
059 59 010 03 2 BSC1 YES 004 DCI 00 A 0 059 UNSHARED 
O5A 5A O11 03 2 BSC1 YES 004 DCI 00 A 0 05A  UNSHARED 
05B 5B 012 03 2 BSC1 YES 004 DCI 00 A 0 05B UNSHARED 
O7F 7F 013 03 2 2741P YES 004 DCI 00 A 0 O07F  UNSHARED 
080 80 014 03 2 2741P YES 004 DCI 00 A 0 080  UNSHARED 
081 81 015 03 2 2741P YES 004 DCI 00 A 0 081 UNSHARED 
082 82 016 03 2 2741P YES 004 DCI 00 A 0 082 UNSHARED 
083 83 017 03 2 2741P YES 004 DCI 00 A 0 083 UNSHARED 
084 84 018 03 2 2741P YES 004 DCI 00 A 0 084  UNSHARED 
035 85 019 03 2 2741P YES 004 DCI 00 A 0 085 UNSHARED 
086 86 O1A 03 2 2741P YES 004 DCI 00 A 0 086 UNSHARED 
087 87 01B 03 2 2741P YES 004 DCI 00 A 0 087  UNSHARED 
088 88 01C 03 2 2741P YES 004 DCI 80 A 0 088 UNSHARED 
089 89 01D 03 2 2741P YES 004 DCI 00 A 0 089  UNSHARED 
08A 8A O1E 03 2 2741P YES 004 DCI 00 A 0 08A  UNSHARED 
08B 8B 01F 03 2 2741P YES 004 DCI 00 A 0 08B UNSHARED 
OA0 AO 020 03 2 BSC3 YES 004 DCI 00 A 0 AO  UNSHARED 
OAl Al 021 03 2 BSC3 YES 004 DCI 00 A 0 OAL UNSHARED 
0A2 A2 022 03 2 BSC3 YES 004 DCI 00 A 0 OA2  UNSHARED 
0A3 AZ 023 03 2 BSC3 YES 004 DCI 00 A 0 0A3 UNSHARED 
0A4 AS 024 03 2 BSC3 YES 004 DCI 00 A 0 0A4  UNSHARED 
0A5 A5 025 03 2 BSC3 YES 004 DCI 00 A 0  OA5  UNSHARED 
0A6 A6 026 03 2 BSC3 YES 004 DCI 00 A 0 OA6  UNSHARED 
0A7 A7 027 03 2 BSC3 YES 004 DCI 00 A 0 OA7  UNSHARED 
0A8 A8 028 03 2 BSC3 YES 004 DCI 00 A 0 OA8 UNSHARED 
0A9 A9 029 03 2 BSC3 YES 004 DCI 00 A 0  OA9 UNSHARED 
OAA AA 02A 03 2 BSC3 YES 004 DCI 00 A 0 OAA  UNSHARED 
OAB AB 02B 03 2 BSC3 YES 004 DCI 00 A 0 OAB  UNSHARED 
OAC AC 02C 03 2 BSC3 YES 004 DCI 00 A 6 OAC  UNSHARED 
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370-XA 370-XA 370-XA LOG. 370-XA 378 
DEVICE UNIT SUB-CHAN CNTL UNIT CNTL UNIT DEVICE CNTL UNIT CHAN PATH IDS CHANNEL 
SIDE 


lott SEE 


NUMBER ADDR NUMBER NUMBER TYPE TYPE MODEL TIMEOUT NUMBER PROTOCOL 


DAD AD 02D 
OAE AE 02E 
OAF 02F 
0B2 030 
0B3 031 
OB4 032 
OBS 033 
OB6 034 
OB7 035 
0B8 036 
0B9 037 
OBA 038 
OBB 039 
OBC 03A 
OBD 038 
OBE 03C 
OBF 03D 
0co O3E 
C1 03F 
0c2 040 
0C3 041 
0C4 042 
0c5 043 
0C6 044 
0C7 045 
0c8 046 
oco 047 
OCA 048 
0cB 049 
Occ 04A 
ocD 04B 
OCE 04C 
OCF 04D 
0D0 04E 
oD1i 04F 
0D2 050 
0D3 051 
0D4 052 
0D5 053 
0D6 054 
0D7 055 
0D8 056 
0D9 

ODA 

0DB 059 
oDc 

oDD 

ODE 

ODF 


(1) 


ET ADDR 


.BSC3 YES 004 DCI 
BSC3 YES 004 DCI 
BSC3 YES 004 DCI 
BSC3 YES 004 DCI 
BSC3 YES 004 DCI 
BSC3 YES 004 DCI 
BSC3 YES 004 DCI 
BSC3 YES 004 DCI 
BSC3 YES 004 DCI 
BSC3 YES 004 DCI 
BSC3 YES 004 DCI 
BSC3 YES 004 DcI 
BSC3 YES 004 DCI 
BSC3 YES 004 DCI 
BSC3 YES 004 DCI 
BSC3 YES DCI 
BSC3 YES DCI 
BSC3 YES DCI 
BSC3 YES DCI 
BSC3 YES DCI 
BSC3 YES DCI 
BSC3 YES DCI 
BSC3 YES DCI 
BSC3 YES DCI 
BSC3 YES 
BSC3 YES 
BSC3 YES 
BSC3 YES 
BSC3 YES 
BSC3 YES 
BSC3 

BSC3 

BSC3 YES DCI 
BSC3 YES DCI 
BSC3 YES 

BSC3 YES 

BSCS 

BSC3 

BSC3 YES 

BSC3 YES 

BSC3 YES 

BSC3 YES 

BSC3 

BSC3 

BSC3 

BSC3 

BSC3 

BSC3 

BSC3 


OAD 
QAE 
OAF 
0B2 
033 
OBS 
OBS 
OB6 
OB7 
0B8 
OB9 
OBA 
OBB 
OBC 
OBD 
OBE 
OBF 
0Cco 
0Ccl 
ace 
0Cc3 
0c4 
0c5 
Océ 
0C7 


DCI 
DCI 
DCI 
DCI 


Qoo0crocnc0cced C0 coeo 
WWAWWNWWNWNAWADW 
oooocoeooocoe 
aoo0ooncoeooo 
HPHHDDHOHHDD 
ooonanoowmooocoo°oeceoeo 


eooooo0ooeonooooooooo 
SEoces0oc cre G2 o0cego0coo 29COCCOCMOCOCO COO O OOO eCOeCceeooeaoCoOOoOoOOoeOoOOoOm | 


DODD DDD PO 1S NG PO PO 1D PO 10.1% 10 [PO MOD PO 19 19.10 19 19 DO PO 1 PO 19.19 19 10 10 19 [PO 19 PO PY PN 1 1910 10 1H 19 1 PON 
PPP rrrrrrrprrprrrrrrrrrrrrprrrrrrrrPrrrrrrrrrrrrprrrprprr,rYr 
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370 
SUB-CHAN 


ASSIGNED 


UNSHARED 
UNSHARED 
UHSHARED 
UNSHARED 
UNSHARED 
UNSHARED 
UNSHARED 
UNSHARED 
UNSHARED 
UNSHARED 
UNSHARED 
UNSHARED 
UNSHARED 
UNSHARED 
UNSHARED 
UNSHARED 
UNSHARED 
UNSHARED 
UNSHAREL 
UNSHAREL 
UNSHAREL 
UNSHAREL 
UNSHARED 
UNSHARED 
UNSHARED 
UNSHARED 
UNSHARED 
UNSHARED 
UNSHARED 
UNSHARED 
UNSHARED 
UNSHARED 
UNSHARED 
UNSHARED 
UNSHARED 
UNSHARED 
UNSHARED 
UNSHARED 
UNSHARED 
UNSHARED 
UNSHARED 
UNSHARED 
UNSHARED 
UNSHARED 
UNSHARED 
UNSHARED 
UNSHARED 
UNSHARED 
UNSHARED 
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370-XA 370-XA 
DEVICE UNIT SUB-CHAN 


NUMBER ADDR NUMBER 


BBD BD 129 
BBE BE 12A 
BBF BF 12B 
cco co 12c 


370-XA LO 
CNTL UNI 


___ NUMBER 


ic 
ic 
ic 
1D 


TYPE 


3330V 
3330V 
3330V 


G. 370-XA 
T CNTL UNIT DEVICE 
TYPE 
2 
2 
2 
2 


TOTALS FOR DEVICES AND CONTROL UNITS: 
A SIDE 370 MODE-~DEVICE CONTROL BLOCKS- 0300 SET 
B SIDE 370 MODE--~DEVICE CONTROL BLOCKS- 0017 SET 
370-XA MODE--0301 DEVICES, 


TOTAL MESSAGES FOR 


O03 DUMMY DEVICES, 


cTc 


I7OQ DEVICE REPORT: 0000 


CNTL UNIT 
MODEL TIMEOUT NUMBER PROTOCOL | 
YES OBO DCI 
OB1 
YES 0BO DCI 
OB1 
YES OBO “DCI 
OB1 
NO oco DCI 


0, 
0, 


030 LOGICAL CONTROL UNITS, 


CHAN PATH IDS CH 
| fs ile) ae (Cs SIDE SET 
23 A 0 
16 A 1 
23 A 0 
16 A 1 
23 A 0 
16 A 1 
17 A 1 


0195 SET 1 CINCLUDES 17 DUMMIES/SET) 
G@O17 SET 1 CINCLUDES 17 DUMMIES/SET) 


WARNING MESSAGES: 


0000 


032 PHYSICAL CONTROL UNITS 


ERROR MESSAGES: 


370 
ANNEL 
ADDR 


BBD 
BBD 
BBE 
BBE 
BBF 
BBF 
cco 


0000 


PAGE 011 
370 
SUB~-CHAN 
ASSIGNED 
UNSHARED 
UNSHARED 
UNSHARED 


UNSHARED 
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IOCP VERSION 3 


REPORT SOURCE IS LVL Al IOCDS, 


IDL=PRACTICE- IOCP GENERATION 
ID2=SAMPLE CONFIGURATION WITH THREE BYTE CHANNELS 


370-XA LOG. 
CONTROL UNIT 
NUMBER 


DEVICE 

CHPID ORDER DEVICE PREFERRED 

Ge coe NUMBER CHPID 

00 002 NONE 

00 004 NONE 

00 012 NONE 

013 NONE 

00 04D NONE 

04E NONE 

04F NONE 

050 NONE 

051 NONE 

052 NONE 

053 NONE 

054 NONE 

055 NONE 

056 NONE 

057 . NONE 

058 NONE 

059 NONE 

O5A NONE 

05B NONE 

O7F NONE 

080 NONE 

081 NONE 

082 NONE 

083 NONE 

084 NONE 

085 NONE 

086 NONE 

087 NONE 

088 NONE 

089 NONE 

O8A NONE 

088 NONE 

OA0 NONE 

OAl NONE 

OA2 NONE 

0A3 NONE 

0A4 NONE 

0A5 NONE 

0A6 NONE 

OA7 NONE 

0A8 NONE 

0A9 NONE 

OAA NONE 

OAB NONE 

OAC NONE 


LEVEL 2 


LOGICAL CONTROL UNIT REPORT PAGE 001 
MODIFIED BY SCREEN INPUT=NO, ACTIVE=NO, UPDATED=NO 


WRITTEN TO PROCESSOR CONTROLLER ON: TIME 14.50 DATE 85.246 


001 
002 
003 
003 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 


PROCESSOR CONTROLLER TIMESTAMP: TIME 14.50 DATE 85.246 


ATTACHING 
CNTL UNIT 
NUMBER 


ATTACHING 
CHPIDS 


is eka) eee ee 


00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
06 
00 
00 
00 
09 
a0 
00 
00 
00 
00 
09 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
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370-XA LOG. DEVICE 


CONTROL UNIT CHPID ORDER DEVICE 
NUMBER Pie ies aaa wea NUMBER 
OAD 
OAE 
OAF 
0B2 
0B3 
0B4 
0B5 
0B6 
0B7 
038 
0B9 
OBA 
OBB 
OBC 
OBD 
OBE 
OBF 
0co 
0C1 
0c2 
0c3 
0C4 
0C5 
0C6 
0C7 
0C8 
0c9 
OCA 
OCB 
occ 
ocD 
OCE 
OCF 
ODO 
ODL 
oD2 
0D3 
0D4 
0D5 
0D6 
0D7 
0D8 
0D9 
ODA 
ODB 
oDC. 
ODD 
ODE 
ODF 
0E0 


PREFERRED 
CHPID 


NONE 
NONE 
NONE 
NONE 
HONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
HONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NORE 
HONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 


ATTACHING 
CNTL UNIT 
NUMBER 


004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
094 
004 
004 
004 
004% 
004 
004 
004 
004 
004 
004 
004 
094 
004 
004 


ATTACHING 
oe 
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370-XA LOG. DEVICE 
CONTROL UNIT CHPID ORDER 
NUMBER Sie abe nee 
1D- 17 


TOTAL MESSAGES FOR LOGICAL CONTROL UNIT REPORT: 0000 


DEVICE 


NUMBER 


BB5 
BB6 
BB7 
BB8& 
BBS 
BBA 
BBB 
BBC 
BBD 
BBE 
BBF 
cco 


PREFERRED 


CHPID 


NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 


ATTACHING 
CNTL UNIT 
NUMBER 


OB1 
OBO 
OB1 
OBO 
OBL 
0B0 
0Bl 
OBO 
OBL 
OBO 
OBl 
OBO 
OB1 
OBO 
OBL 
OBO 
OB1 
0B0 
OBL 
OBO 
OBi 
0BO 
OBL 
ocd 


WARNING MESSAGES: 


ATTACHING 
CHPIDS 


0000 


ERROR MESSAGES: 


0000 
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IDL=PRACTICE IOCP GENERATION 
ID2Z=SAMPLE CONFIGURATION WITH THREE BYTE CHANNELS 


CHPID 
00 


370° CHAN 
NUMB SET 
0 0 


SIDE MODE 
A BYTE 


REPORT SOURCE IS LVL 


CONTROL UNIT 


NUMBER 


001 


002 


803 


004 


TYPE-MODEL 


3811 


3811 


3505 


3705 


TOCP VERSI 
Al IocbDs, 


370-XA 
CNTL UNIT 


TYPE 


ON 3 LEVEL 2 
MODIFIED BY SCREEN INPUT=NO, 


CHANNEL PATH ID REPORT 


ACTIVE=NO, 


UPDATE 


WRITTEN TO PROCESSOR CONTROLLER ON: 
PROCESSOR CONTROLLER TIMESTAMP: TIME 14.50 DATE 85.246 


370-XA LOG. 
CNTL UNIT 


NUMBER 


00 


01 


02 


03 


‘PROTOCOL 


DCI 
DCI 


DCI 


DCI 


370~XA 


UNIT ADDR RANGE DEVICE 


FROM 


02 


04 


TO 


02 


04 


NUMBER 


912 
013 


D=NO 


PAGE 001 


TIME 14.50 DATE 85.246 


UNIT 
ADDR 


02 
04 


12 
13 


DEVICE 
TYPE-MODEL 


3211 


3211 


3505 
3525 


BSC1 
BSC1 
BSC1 
BSC1 
BSC1 
BSC1 
BSC1 
BSCl 
BSC1 
BSCl 
BSC1 
BSCl 
BSC1 
BSC1l 
BSC1 
2741P 
2741P 
2741P 
2741P 
2741P 
2741P 
2741P 
2741P 
2741P 
2741P 
2741P 
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CHPID 


370 CHAN 
NUMB SET 


SIDE 


CONTROL UNIT 


NUMBER 


TYPE-MODEL 


370-XA 
CNTL UNIT 


370-XA LOG. 
CNTL UNIT 
NUMBER 


PROTOCOL 


370-XA 
UNIT ADDR RANGE DEVICE 
FROM 


UNIT 
ADDR 


PAGE 013 


DEVICE 


3330 
3330 


3350 
3350 
3350 
3350 


3350 
3350 
3350 
3350 


3380 
3380 
3380 
3380 


TYPE-MODEL 


1 
1 


1 
1 
1 
1 
1 
1 
1 
1 
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370 CHAN 
CHPID NUMB SET 


TOTAL MESSAGES FOR 


246 


CONTROL UNIT 
SIDE MODE NUMBER  TYPE-MODEL 


CHANNEL PATH ID REPORT: 


0000 


370-XA 
CNTL UNIT 
TYPE 


370-XA LOG. 
CNTL UNIT 
NUMBER PROTOCOL 


WARNING MESSAGES: 


UNIT ADDR RANGE 


FROM 


0000 


TO 


370-XA 
DEVICE 


MESSAGES: 


0000 


PAGE 014% 


DEVICE 


TYPE-MODEL 


3350 
33590 
3350 
3350 


Chapter 6. IOCP Messages 


This chapter describes the [OCP messages for both: 


e¢ ICP prefix 
¢ DMSICP prefix 


IOCP Messages (ICP Prefix) 


This section describes the messages produced by all versions of IOCP. The messages 
are described in alphanumeric order by message identifier and include, for each 
message: 


¢ The module that detects the need for the message (detecting module) 
¢ The module that issues the message or calls the message module (issuing module) 
¢ The module that contains the message text (containing module) 


Message ICPOSOD is sent to the MVS system operator’s console and requests action 
by the system operator. The operator later receives either message ICPOSO6I or 
ICP0507I to indicate whether the IOCP job was successful or failed. All other 
messages are sent to the output printer for the JOCP programmer (running the MVS 
or VM version of JOCP) and/or the console screen for the IOCP operator (running 
the stand-alone version of IOCP). 


The message format is: 


IcPnnns: text 


where: 
nnn is the message serial number. 
S is the type code: 


A Action; the operator must perform a specific action 

D_ Decision: the operator must choose an alternative 

1 Information; no operator action is required 

W_ Wait; processing stops until an action is determined and performed 


text is the message text. 
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ICP000l UNDEFINED MESSAGE CODE. CODE = xxxxxxxx HEX 


Explanation: Message code xxxxxxxx has been generated by IOCP for which a 
message has not been defined. A logical error has occurred in IOCP. | 


System Action: [OCP action is unpredictable. 


Programmer Response: Rerun the IOCP job. If the problem occurs again, save the 
console sheet and all associated output. Notify your system programmer. 


Detecting Module: ICPCMSG 
Issuing Module: ICPCMSG 
Containing Module: ICPCMSG 


ICP050D SHOULD jobname WRITE TO LEVEL xxx IOCDS? REPLY ‘YES’, 
‘NO’, OR ‘CANCEL’ 


Explanation: A job with name “jobname” is executing IOCP with a WRTCDS 
option other than NO on the PARM parameter of the EXEC statement. IOCP 
issues this message to request permission from the MVS system operator for the job 
to write to the level xxx IOCDS in the processor controller. 


Note: If two (or more) jobs are allowed to concurrently update (write to) the level 
xxx IOCDS, the outcome could be an IOCDS that is logically inconsistent with the 
input from any one job. Using this IOCDS at power-on reset or SYSIML CLEAR 
could produce undesirable results. 


System Action: An operator reply of ‘YES’ allows the job to continue executing 
and, if no errors are encountered, to replace the input/output configuration data in 
the level xxx JOCDS in the processor controller with the input/output configuration 
data generated by this job. The operator should use the IOCDSM frame to ensure 
the level xxx IOCDS is not write-protected. A reply of ‘NO’ allows the job to 
continue generating input/output configuration data in storage and to produce 
reports, but does not permit the job to replace the input/output configuration data in 
the level xxx IOCDS in the processor controller. A reply of ‘CANCEL’ terminates 
the job immediately with the system code X‘222’. 


Operator Response: Contact your system programmer and respond as instructed. 
Programmer Response: Follow your installation procedures and advise the operator. 
Detecting Module: ICPPCNTL 

Issuing Module: ICPPCNTL 

Containing Module: ICPPCNTL 

Routing Codes: | and 11 

Descriptor Code: 7 


6-2 JIOCP User’s Guide and Reference 


ICP051J IOCP TERMINATED. CODE =xx 


Explanation: IOCP has terminated for one of the following reasons: 


Code Description 


01 


03 
04 
05 


06 


07 
08 


09 


0A 
OB 
OC 
10 


4x 


5x 


6x 


An unknown keyword value was found on the PARM parameter of the 
EXEC statement. (This code can result from an extra left parenthesis after 
the REPORT keyword.) 


A duplicate keyword was found on the PARM parameter of the EXEC 
statement. 


An unknown keyword was found on the PARM parameter of the EXEC 
statement. 


The keyword value on the LINECOUNT keyword on the PARM parameter 
of the EXEC statement was not within the allowed range. 


Conflicting keywords were found on the PARM parameter of the EXEC 
statement. 


An extra or missing comma was found on the PARM parameter of the EXEC 
statement. This code can result from unbalanced parentheses around the 
REPORT parameter(s). 


One or more errors were found in the input card-image macro instructions. 
See the listing for related error messages. 


An error was found while IOCP was generating the IOCDS in storage. See 
the listing for related error messages. 


The operator replied ‘NO’ to message ICPO50D or the VM user did not have 
privilege class C. The level xxx IOCDS in the processor controller was not 
replaced. 


IOCP encountered an error while writing the LVL1 IOCDS in the processor 
controller. See the listing for related error messages. 


IOCP encountered an error while reading the LVLO IOCDS from the 
processor controller. See the listing for related error messages. 


IOCP encountered an error while reading the LVL1 IOCDS from the 
processor controller. See the listing for related error messages. 


A REPORT or WRTCDS option has been specified but ICPIOCP only reads 
or writes an IOCDS on a 308x processor. 


IOCP encountered an error while reading/writing the level Ax IOCDS (where 
x is 0, 1, 2, or 3) from/to the processor controller. See the listing for related 
error messages. 


IOCP encountered an error while reading/writing the level Bx IOCDS (where 
x is 0, 1, 2, or 3) from/to the processor controller. See the listing for related 
error messages. 


IOCP encountered an error while doing a dual write of the Ax and Bx 
IOCDS (where x is 0, 1, 2, or 3) to the processor controller. See the listing 
for related error messages. 


System Action: If IOCP encountered an error while doing anything other than 
reading an IOCDS, it terminates with return code 8. If [OCP encountered an error 
while reading an IOCDS, it terminates the read operation for that IOCDS. 
However, IOCP will attempt to read each additional IOCDS that was specified 
before it terminates with return code 8. 
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Programmer Response: Ensure that the PARM parameter on the EXEC statement 
is coded correctly. For processor controller errors, save the output listings and 
report the problem to the customer engineer. 


Detecting Module: 
ICPPCNTL detects codes 01 through 06, 09 and 10 
ICPCARDS detects code 07 
ICPCGNDS detects code 08 
ICPCRTNS detects codes 0A, 0B, OC, 4x, 5x, and 6x 
Issuing Module: ICPPCNTL 
Containing Module: ICPCMSG 
ICP052I DCB DID NOT OPEN - SYSIN DD STATEMENT MAY BE 
MISSING/INVALID 


Explanation: The DCB for the data set specified on the SYSIN DD statement did 
not open when IOCP issued the OPEN macro instruction. 


System Action: IOCP terminates. 


Programmer Response: Ensure that the DD statement for the SYSIN data set is 
valid. 


Detecting Module: ICPCGET 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 

ICP054I **WARNING** THE ABOVE I/O DEVICE IS NOT CONNECTED 
TO THE SPECIFIED PRIMARY CHANNEL ADDRESS 


Explanation: IOCP has found an I/O device that is not assigned to its primary 
channel. (For example, a device with address 180 is not assigned to channel 1.) 

You define the primary channel address for a device on the ADDRESS parameter of 
the IODEVICE macro instruction by specifying the channel number that 
corresponds to the lowest numbered channel path to which the device is assigned. 


System Action: IOCP prints this warning message following the I/O device in 
question. [OCP continues processing. 


Programmer Response: Ensure that the I/O configuration is correctly defined. 

Detecting Module: ICPCRPT 

Issuing Module: ICPCRPT 

Containing Module: ICPCMSG 

ICP0S5I. =**WARNING** DEVICE NUMBER DOES NOT MATCH UNIT 
ADDRESS 


Explanation: The second and third digits of the device number (specified on the 
ADDRESS keyword) do not match the unit address specified on the UNITADD 
keyword of the IODEVICE macro instruction. 


System Action: IOCP prints this warning message following the I/O device in 
question. IOCP continues processing. 
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Programmer Response: Remember this difference if the device is used in 370 mode 
or if you are reviewing EREP reports. 


Detecting Module: ICPCRPT 
Issuing Module: ICPCRPT 
Containing Module: ICPCMSG 


ICP056I IOCP JOB jobname FAILED. DID NOT BUILD LEVEL xxx IOCDS. 


Explanation: A job with name “jobname” was executing IOCP with the 
WRTCDS = xxx option on the PARM parameter of the EXEC statement. IOCP 
issues this message to inform the MVS system operator (who previously responded 
to message ICPOS0D) that this job failed to build the level xxx IOCDS. 


System Action: IOCP terminates the job with return code 8. 
Operator Response: Tell your system programmer that the job failed. 


Programmer Response: Review the messages on the job listing and take the 
necessary actions. 


Detecting Module: ICPPCNTL 
Issuing Module: ICPPCNTL 
Containing Module: ICPPCNTL 
Routing Codes: 2 and 11 
Descriptor Code: 6 


ICP057I YOCP JOB jobname SUCCESSFUL. LEVEL xxx IOCDS REPLACED. 


Explanation: A job with name “jobname” was executing IOCP with the 
WRTCDS = xxx option on the PARM parameter of the EXEC statement. IOCP 
issues this message to inform the MVS system operator (who previously granted 
permission to write the IOCDS in response to message ICPOSOD) that this job 
successfully replaced the level xxx IOCDS. 


System Action: IJOCP terminates the job with return code 0 or 4. 

Operator Response: Follow your installation procedures. 

Detecting Module: ICPPCNTL 

Issuing Module: ICPPCNTL 

Containing Module: ICPPCNTL 

Routing Codes: 2 and 11 

Descriptor Code: 6 

ICP100I SYMBOL IN NAME FIELD EXCEEDS 8 CHARACTERS AND/OR 
CONTAINS INVALID CHARACTERS 


Explanation: The symbolic name that appears in the name field contains more than 
8 characters and/or contains invalid characters. 


System Action: IOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an IOCDS in storage and does not produce 
configuration reports. 


Programmer Response: Correct the name field. 
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Detecting Module: ICPCARDS 
Issuing Module: ICPCARDS 
Containing Module: ICPCMSG 


ICP1011 OP CODE NOT FOUND ON FIRST OR ONLY CARD 


Explanation: The operation field (macro instruction name) was not found before 
column 72. 


System Action: ITOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an IOCDS in storage and does not produce 
configuration reports. 


Programmer Response: Check for format errors and correct the errors. 
Detecting Module: ICPCARDS 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 


ICP102I UNSUPPORTED OP CODE 


Explanation: The operation field does not contain a valid IOCP macro instruction 
name. 


System Action: JOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an IOCDS in storage and does not produce 
configuration reports. 


Programmer Response: Use a valid IOCP macro instruction name in the operation 
field, or set IGNORE= YES to ignore non-IOCP macro instruction names. 


Detecting Module: ICPCARDS 
Issuing Module: ICPCARDS 
Containing Module: ICPCMSG 


ICP103I = **WARNING** ID STATEMENT IGNORED - OUT OF SEQUENCE 


Explanation: [OCP found an ID macro instruction after processing one or more 
other IOCP macro instructions. 


System Action: IOCP ignores the ID macro instruction that is out of sequence and 
continues processing. 


Programmer Response: Ensure that the ID macro instruction is the first IOCP 
macro instruction in the input. 


Detecting Module: ICPCARDS 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 

ICP1041 **WARNING** MORE THAN ONE ID STATEMENT - ONLY THE 
FIRST WAS USED 


Explanation: More than one ID macro instruction was found in the input macro 
instructions. Only one ID macro instruction can be specified. 


System Action: IOCP processes the first [ID macro instruction, ignores any 
following ID macro instructions, and continues processing. 
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Programmer Response: Ensure that there is only one ID macro instruction in the 
input and that it is the first IOCP macro instruction. 


Detecting Module: ICPCARDS 
Issuing Module: ICPCARDS 
Containing Module: ICPCMSG 


ICP1051 OPERAND FIELD NOT FOUND 


Explanation: The operand field was not found before column 72. Ona 
continuation card, the operand field must start in column 16. 


System Action: JOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an IOCDS in storage and does not produce 
configuration reports. 


Programmer Response: Correct the operand field. 

Detecting Module: ICPCARDS 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 

ICP1061 NON-BLANK CHARACTER(S) FOUND IN COLUMNS 1-15 OF 
CONTINUATION CARD 


Explanation: A non-blank character was found in columns | to 15. Ona 
continuation card, columns | to 15 must be blank and the operand field must start 
in column 16. (The preceding card had a non-blank character in column 72, 
indicating that this is a continuation card.) 


System Action: IOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an IOCDS in storage and does not produce 
configuration reports. 


Programmer Response: Ensure that the operand field on the continuation card starts 
in column 16. 


Detecting Module: ICPCARDS 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 

ICP1071 **WARNING** EXCEEDED THE ALLOWED NUMBER OF 
COMMENT CONTINUATION CARDS 


Explanation: More than two continuation cards were found for an IOCP comment 
card. 


System Action: JOCP prints the extra comment continuation cards and continues 
processing. 


Programmer Response: Restructure the comment so that it can be contained in a 
total of three comment cards, or code an asterisk in column | (or *IOCP in columns 
1 to 5) and remove the continuation characters in column 72 of the preceding 
card(s). 


Detecting Module: ICPCARDS 
Issuing Module: ICPCARDS 
Containing Module: ICPCMSG 
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ICP108I UNEXPECTED END OF FILE ON SYSTEM INPUT (SYSIN) 


Explanation: A continuation card was expected when an end-of-file occurred on the 
input data set. The last card contains a non-blank character in column 72. 


System Action: IOCP does not generate an IOCDS in storage and does not produce 
configuration reports. 


Programmer Response: Ensure that no macro instructions or comment cards are 
missing in the input. 


Detecting Module: ICPCARDS 
Issuing Module: ICPCARDS 
Containing Module: ICPCMSG 


ICP1091 MISSING LEFT PARENTHESIS 


Explanation: A missing left parenthesis was detected. The parameter requires the 
keyword value field to be enclosed in parentheses. . 


System Action: IOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an IOCDS in storage and does not produce 
configuration reports. 


Programmer Response: Correct the parameter. 
Detecting Module: ICPCARDS, ICPCARDX 
Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 


ICP1101. EXTRA LEFT PARENTHESES 


Explanation: The parameter requires | or 2 left parentheses to start the keyword 
value field. More than the required 1 or 2 were found. 


System Action: IOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an IOCDS in storage and does not produce 
configuration reports. 


Programmer Response: Correct the parameter. 

Detecting Module: ICPCARDS, ICPCARDX 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 

ICP1III **WARNING** PATH INFORMATION DEFINED WITH ** IS 
EXCLUDED FROM IOCDS 


Explanation: The characters ** were detected instead of a chpid number on the 
PATH parameter. The ** indicate a channel used only by processors other than the 
processor complexes listed on the cover of this manual. 


System Action: IOCP prints this warning message following the CHPID macro 
instruction that contains **. IOCP does not include in the IOCDS the channel 
number and channel set following the characters **. Processing continues. 


Programmer Response: Ensure that the characters ** were specified for the intended 
channel number and channel set. 


Detecting Module: ICPCARDS 
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Issuing Module: ICPCARDS 
Containing Module: ICPCMSG 


ICP112T DELIMITER ERROR, EXPECT BLANK OR COMMA 


Explanation: A character (such as a right parenthesis) was found where a blank or 


comma is required, or a keyword value contained too many digits. 


System Action: IOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an IOCDS in storage and does not produce 
configuration reports. 


Programmer Response: Correct the parameter or the delimiter. 

Detecting Module: ICPCARDX 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 

ICP113I DELIMITER ERROR, EXPECT COMMA OR RIGHT 
PARENTHESIS 


Explanation: A character (such as a blank) was found where a comma or right 
parenthesis is required. 


System Action: IOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an IOCDS in storage and does not produce 
configuration reports. 


Programmer Response: Correct the parameter or the delimiter. 

Detecting Module: ICPCARDX 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 

ICP1141 INVALID DELIMITER, ONLY BLANK, COMMA OR RIGHT 
PARENTHESIS IS EXPECTED 


Explanation: A character other than a blank, comma, or right parenthesis was 


found where a valid delimiter is required, or a keyword value contained too many 


digits. 


System Action: [OCP continues to check the syntax of the remaining macro 
instructions, but does not generate an IOCDS in storage and does not produce 
configuration reports. 


Programmer Response: Correct the parameter and/or supply the correct ending 
delimiter. 


Detecting Module: ICPCARDX 
Issuing Module: ICPCARDS 
Containing Module: ICPCMSG 
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ICP115I DELIMITER ERROR, EXPECT RIGHT PARENTHESIS 


Explanation: A character (such as a blank or comma) was found where a right 
parenthesis is required, a keyword value contained too many digits, or too many 
keyword values were specified. . 


System Action: IOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an IOCDS in storage and does not produce 
configuration reports. 


Programmer Response: Correct the parameter and/or correct the invalid delimiter 
with a right parenthesis. 


Detecting Module: ICPCARDX 
Issuing Module: ICPCARDS 
Containing Module: ICPCMSG 


ICP116I DELIMITER ERROR, EXPECT LEFT PARENTHESIS 


Explanation: A character other than a left parenthesis was found where a left 
parenthesis is required. 


System Action: IOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an IOCDS in storage and does not produce 
configuration reports. 


Programmer Response: Check for incorrect characters in the parameter and/or 
correct the delimiter. 


Detecting Module: ICPCARDS, ICPCARDX 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 

ICP117I **WARNING** THE ABOVE DEVICE(S) EXCLUDED FROM 
IOCDS 


Explanation: The characters *** were detected as the keyword value for the 
CUNUMBR parameter. The *** indicate that the I/O device(s) are used only by 
processors other than the processor complexes listed on the cover of this manual. 


System Action: IOCP prints this warning message following the IODEVICE macro 
instruction that contains ***. IOCP does not include the device(s) in the IOCDS. 
Processing continues. . 


Programmer Response: Ensure that the device(s) defined by the IODEVICE macro 
instruction are to be excluded from the IOCDS. 


Detecting Module: ICPCARDX 
Issuing Module: ICPCARDX 
Containing Module: ICPCMSG 
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ICP118I **WARNING** OPTCHAN SYNTAX/VALUE ERRORS DETECTED 


Explanation: The OPTCHAN parameter on the IODEVICE macro instruction 
contains one or more syntax or value errors. The possible errors are: 


¢ OPTCHAN keyword was specified more than once. 
¢ Invalid delimiter follows the keyword value. 


¢ Keyword value is not a hexadecimal digit or contains more than one 
hexadecimal digit. 


¢ Keyword value specifies an alternate channel that is not greater than the primary 
channel. 


System Action: [OCP prints this warning message following the IODEVICE macro 
instruction in question. Because of the error, IOCP does not attempt to validate 
that a path exists from the device(s) to the alternate channel specified by the 
OPTCHAN keyword. value. IOCP continues processing. 


Programmer Response: Ensure that the OPTCHAN parameter is correctly coded. 
Detecting Module: [CPCARDX 

Issuing Module: ICPCARDX 

Containing Module: ICPCMSG 


ICP1191 BEGINNING APOSTROPHE NOT FOUND 


Explanation: The beginning apostrophe was not found in a parameter that requires 
the keyword value to be enclosed in apostrophes. 


System Action: IOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an IOCDS in storage and does not produce 
configuration reports. 


Programmer Response: Correct the parameter. 
Detecting Module: ICPCARDS 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 


ICP1201_ ENDING APOSTROPHE NOT FOUND 


Explanation: The ending apostrophe was not found in a parameter that requires the 
keyword value to be enclosed in apostrophes. : 


System Action: [OCP continues to check the syntax of the remaining macro 
instructions, but does not generate an IOCDS in storage and does not produce 
configuration reports. 


Programmer Response: Correct the parameter. 
Detecting Module: ICPCARDS 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 
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ICP121I OPERAND FIELD IS TOO LONG TO PROCESS 


Explanation: The length of the operand field is greater than the length IOCP can 
process for operand fields. 


System Action: [OCP continues to check the syntax of the remaining macro 
instructions, but does not generate an IOCDS in storage and does not produce 
configuration reports. 


Programmer Response: Check that the macro instruction and continuation cards are 
correctly specified. 


Detecting Module: ICPCARDS 
Issuing Module: ICPCARDS 
Containing Module: ICPCMSG 


ICP1221. NOT ALL THE REQUIRED PARAMETERS WERE SPECIFIED 


Explanation: At least one of the required parameters was not found on the macro 
instruction. This message may indicate that a continuation character was missing 
from column 72. 


System Action: IOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an I[OCDS in storage and does not produce 
configuration reports. 


Programmer Response: Ensure that all required parameters are specified. Ensure 
that all continuation characters are correctly specified. 


Detecting Module: ICPCARDS, ICPCARDX 
Issuing Module: ICPCARDS 
Containing Module: [CPCMSG 


ICP1231 DUPLICATE KEYWORDS ON STATEMENT 


Explanation: A keyword parameter was found more than once on the macro 
instruction. Keyword parameters cannot be repeated on the same macro instruction. 


System Action: IOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an IOCDS in storage and does not produce 
configuration reports. 


Programmer Response: Ensure that keyword parameters are not duplicated. 
Detecting Module: ICPCARDS, ICPCARDX 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 


ICP124l TOO MANY KEYWORD VALUES SPECIFIED 


Explanation: More than the allowed number of keyword values were found on the 
parameter. 


System Action: IOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an IOCDS in storage and does not produce 
configuration reports. 


Programmer Response: Ensure that the number of keyword values does not exceed 
the maximum allowed. 
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Detecting Module: ICPCARDS, ICPCARDX 
Issuing Module: ICPCARDS 
Containing Module: ICPCMSG 


ICP125I PARAMETER CONTAINS NON-NUMERIC CHARACTERS 


Explanation: A character other than 0 through 9 was found on a parameter for a 
keyword value that requires a decimal value. 


System Action: IOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an IOCDS in storage and does not produce 
configuration reports. 


Programmer Response: Correct the keyword value. 
Detecting Module: [CPCARDX 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 


ICP1261 PARAMETER CONTAINS NON-HEXADECIMAL CHARACTERS 


Explanation: A character other than 0 through 9 or A through F was found on a 
parameter for a keyword value that requires a hexadecimal value, or not enough 
digits were specified on a keyword value. (Note that the channel path identifier on 
the PATH parameter requires two digits.) 


System Action: IOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an IOCDS in storage and does not produce 
configuration reports. 


Programmer Response: Correct the keyword value. 
Detecting Module: ICPCARDS, ICPCARDX 
Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 


ICP127I UNKNOWN OR DUPLICATE KEYWORD 


Explanation: An unknown keyword parameter was found on the macro instruction, 
or duplicate keyword parameters were specified. If a continuation card generates this 
message, a comma may be missing on the previous card. 


System Action: IOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an JOCDS in storage and does not produce 
configuration reports. 


Programmer Response: Correct the unknown or duplicate keyword parameter. If 
this is an JODEVICE macro instruction and the keyword is a valid system 
generation keyword, set the IGNORE= YES option so that IOCP will ignore 
non-IOCP parameters. 


Detecting Module: ICPCARDS, ICPCARDX 
Issuing Module: ICPCARDS 
Containing Module: ICPCMSG 
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ICP128I1 INVALID PROTOCL VALUE. MUST BE D, S OR S4 


Explanation: A character other than D, S or S4 was found as the keyword value on 
the PROTOCL parameter. 


System Action: IOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an IOCDS in storage and does not produce 
configuration reports. 


Programmer Response: Correct the keyword value. 
Detecting Module: ICPCARDX 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 


ICP1291 INVALID SHARED VALUE. MUST BE Y OR N or YB 


Explanation: Character(s) other than Y or N or YB were found as the keyword 
value on the SHARED parameter. 


System Action: IOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an IOCDS in storage and does not produce 
configuration reports. 


Programmer Response: Correct the keyword value. 
Detecting Module: ICPCARDX 

Issuing Module: I[CPCARDS 

Containing Module: ICPCMSG 


ICP130I PATH PARAMETER - CHPID VALUE INVALID 


Explanation: A channel path identifier, found on the PATH parameter or entered 
from the console screen, is not within the range of valid channel paths. 


System Action: (1) If the input is from card-image macro instructions, IOCP 
continues to check the syntax of the remaining macro instructions but does not 
generate an IOCDS in storage and does not produce configuration reports. (2) If 
the input is from the console screen, the channel path is not added. 


Programmer Response: (1) For input from card-image macro instructions, correct 
the channel path identifier on the PATH parameter. (2) For input from the console 
screen, enter the correct channel path. 


Detecting Module: ICPCARDS, ICPCARDX 
Issuing Module: ICPCARDS, ICPSMAIN 
Containing Module: ICPCMSG 


ICP131I PATH PARAMETER - NO CHANNEL SPECIFIED 


Explanation: A required channel number was not found on the PATH parameter 
for its associated channel path. 


System Action: IOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an IOCDS in storage and does not produce 
configuration reports. 


Programmer Response: Supply the missing channel number. 


Detecting Module: ICPCARDS 
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Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 

ICP1321 PATH PARAMETER - INVALID CHANNEL SET VALUE. MUST BE 
0OR 1 


Explanation: A character other than 0 or 1 was found on the PATH parameter as a 
keyword value for the channel set. 


System Action: IOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an IOCDS in storage and does not produce 
configuration reports. 


Programmer Response: Correct the channel set value. 
Detecting Module: ICPCARDS 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 


ICP133I INVALID TYPE VALUE. MUST BE BY OR BL 


Explanation: A keyword value other than BY or BL was found on the TYPE 
parameter. 


System Action: IOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an IOCDS in storage and does not produce 
configuration reports. 


Programmer Response: Correct the keyword value. 
Detecting Module: ICPCARDS 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 


ICP134I INVALID CONTROL UNIT NUMBER 


Explanation: A control unit number other than a hexadecimal value in the range of 
000 through 3FF was found on the CUNUMBR parameter or entered from the 
console screen. 


System Action: (1) If the input is from card-image input, IOCP continues to check 
the syntax of the remaining macro instructions, but does not generate an IOCDS in 
storage and does not produce configuration reports. (2) If the input is from the 
console screen, the control unit is not added. 


Programmer Response: (1) For input from card-image macro instructions, correct 
the control unit number on the CONUMBR parameter. (2) For input from the 
console screen, enter the correct control unit. 


Detecting Module: ICPCARDX 
Issuing Module: ICPCARDS, ICPSMAIN 
Containing Module: ICPCMSG 
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ICP135I INVALID UNITADD NUMBER 


Explanation: On the UNITADD parameter, a keyword value for number was not 
within the allowable range of decimal | through 256. 


System Action: IOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an IOCDS in storage and does not produce 
configuration reports. 


Programmer Response: Correct the keyword value. 
Detecting Module: ICPCARDX 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 


ICP1361 INVALID DEVICE ADDRESS NUMBER 


Explanation: On the ADDRESS parameter, a keyword value for number was not 
within the allowable range of decimal | through 256. 


System Action: [OCP continues to check the syntax of the remaining macro 
instructions, but does not generate an IOCDS in storage and does not produce 
configuration reports. 


Programmer Response: Correct the keyword value. 
Detecting Module: ICPCARDX 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 


ICP137I UNIT ADDRESS PLUS NUMBER EXCEEDS HEX ADDRESS FF 


Explanation: The keyword value for the unit address (specified on either the 

UNITADD keyword or the ADDRESS keyword) plus the keyword value for 
number (specified on the ADDRESS keyword) exceeds the allowable value of 
hexadecimal FF for a unit address. 


System Action: IOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an IOCDS in storage and does not produce 
configuration reports. 


Programmer Response: Correct the keyword values. 
Detecting Module: ICPCARDX 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 


ICP138I NO IOCP STATEMENTS FOUND 


Explanation: An end-of-file has occurred on the SYSIN data set before IOCP found 
a CHPID, CNTLUNIT, or IODEVICE macro instruction. 


System Action: IOCP does not generate an IOCDS in storage and does not produce 
configuration reports. 


Programmer Response: Ensure that the correct data set was specified for SYSIN. 


Detecting Module: ICPCARDS 
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Issuing Module: ICPCARDS 

Containing Module: I[CPCMSG 

ICP1391 UNIT OR MODEL PARAMETER CONTAINS 
NON-ALPHANUMERIC CHARACTERS 


Explanation: A non-alphanumeric character was entered from the console screen or 
was found on the UNIT or MODEL parameter. The characters allowed are 0 
through 9 and A through Z. 


System Action: (1) If the input is from card-image input, IOCP continues to check 
the syntax of the remaining macro instructions, but does not generate an IOCDS in 
storage and does not produce configuration reports. (2) If the input is from the 
console screen, the I/O device is not added. 


Programmer Response: (1) For input from card-image macro instructions, correct 
the UNIT and/or MODEL parameters. (2) For input from the console screen, enter 
the correct UNIT and/or MODEL values. 


Detecting Module: ICPCARDX 
Issuing Module: ICPCARDS, ICPSMAIN 
Containing Module: ICPCMSG 


ICP1401 INVALID TIMEOUT VALUE. MUST BE Y OR N 


Explanation: A character other than Y or N was found as the keyword value on the 
TIMEOUT parameter. 


System Action: [OCP continues to check the syntax of the remaining macro 
instructions, but does not generate an IOCDS in storage and does not produce 
configuration reports. 


Programmer Response: Correct the keyword value. 

Detecting Module: ICPCARDX 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 

ICP141I **WARNING** THE ABOVE DEVICE(S) DOES NOT HAVE A 
PATH TO OPTCHAN x 


Explanation: IOCP did not find a path from the device(s) to the alternate channel 
specified by the OPTCHAN value on the IODEVICE macro instruction. 


System Action: IOCP prints this warning message following the IODEVICE macro 
instruction in question and continues processing. . 


Programmer Response: Ensure that the value specified for the OPTCHAN 
parameter is correct and, by checking the associated CNTLUNIT and CHPID 
macro instructions, ensure that there is a path from the device(s) through a control 
unit to the alternate channel. 


Detecting Module: [CPCARDX 
Issuing Module: [CPCARDX 
Containing Module: ICPCMSG 
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ICP142I **WARNING** DEFAULT OF n USED FOR NUMBER OF UNITS 
SUBPARAMETER 


Explanation: (1) For the 2305 Fixed Head Storage and the 3838 Array Processor, 
IOCP unconditionally assigns a value of 8 to the number of units subparameter. (2) 
When UNIT =3350P or UNIT =3351P, IOCP unconditionally assigns a value of 2 
to the number of units subparameter if the user specified 1. (3) When 

UNIT = 3351P, IOCP unconditionally assigns a value of 4 to the number of units 
subparameter if the user specified 3. 


System Action: IOCP prints this warning message following the IODEVICE macro 
instruction in question and continues processing. 


Programmer Response: Ensure that the UNIT and ADDRESS parameters on the 
IODEVICE macro instruction are correctly coded. If UNIT =2305 or UNIT = 3838, 
code the value 8 for the number keyword on the ADDRESS parameter. If 

UNIT = 3350P, code a value from 2 to 8. If UNIT =3351P, code a value of 2 or 4. 


Detecting Module: ICPCARDX 
Issuing Module: ICPCARDX 
Containing Module: ICPCMSG 


ICP1431 **WARNING** UNABLE TO VALIDATE OPTCHAN FOR 
CHANNEL x DUE TO NON-308X ASSIGNMENT 


Note: This message applies to all the processor complexes listed on the 
cover of this manual, not just the 308X Processor Complex. 


Explanation: IOCP did not find a path from the device(s) to the alternate channel 
specified by the OPTCHAN value on the IODEVICE macro instruction. Channel x 
is defined as a channel used only by processors other than the processor complexes 
listed on the cover of this manual; therefore, channel x is not included in the 
IOCDS. 


System Action: IOCP prints this warning message following the IODEVICE macro 
instruction in question and continues processing. 


Programmer Response: Ensure that a path from the device(s) to the alternate 
channel is not needed for I/O requests on a processor complex listed on the cover of 
this manual. 


Detecting Module: [CPCARDX 
Issuing Module: ICPCARDX 
Containing Module: ICPCMSG 


ICPi44Il xyz IS AN UNACCEPTABLE BASE ADDRESS FOR UNIT 335xP 


Explanation: For UNIT 3350P, the address xyz is an unacceptable base address 
because bits 3 and 4 of the binary value of the byte representing y and z must be 
zeroes. The binary value of the base address xyz must be of the form “nnnn nnnO 
Onnn”. Thus, y must be an even hexadecimal digit (0, 2, 4, 6, 8, A, C, or E) and z 
must be in the range of 0 through 7. 


For UNIT 3351P, the address xyz is an unacceptable base address because bits 4 and 
5 of the binary value of the byte representing y and z must be zeroes. The binary 
value of the base address xyz must be of the form “nnnn nnnn 00nn”. Thus, y may 
be a hexadecimal digit of 0 through F and z must be in the range of 0 through 3. 
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System Action; JOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an [OCDS in storage and does not produce 
configuration reports. 


Programmer Response: Ensure that the UNIT and ADDRESS parameters on the 
IODEVICE macro instruction are correctly coded. 


Detecting Module: ICPCARDX 

Issuing Module: ICPCARDX 

Containing Module: ICPCMSG 

ICP1451 DEVICE ADDRESS PLUS NUMBER OF UNITS EXCEEDS HEX 
FFF 

Explanation: On the ADDRESS parameter, the keyword value for unit address plus 


the keyword value for number exceeds the allowable value of hexadecimal FFF for a 
device address. 


System Action; IOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an [OCDS in storage and does not produce 
configuration reports. 


Programmer Response: Correct the keyword values. 
Detecting Module: ICPCARDX 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 


ICP200I CHPID xx PREVIOUSLY DEFINED 


Explanation: The user has defined a channel path (xx) to be added to the IOCDS, 
but an entry for channel path xx already exists in the [OCDS in storage. 


System Action: (1) If the input is from card-image macro instructions, IOCP deletes 
any channel path entries that were added from multiple definitions on the CHPID 
macro instruction. JOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an IOCDS in storage and does not produce 
configuration reports. (2) If the input is from the console screen, the channel path is 
not added. 


Programmer Response: (1) For input from card-image macro instructions, ensure 
that duplicate channel paths are not specified on the CHPID macro instructions. (2) 
For input from the console screen, use the display, alter, and delete functions to 
check and correct the channel path entries. 


Detecting Module: [CPCIOCP 
Issuing Module: ICPCARDS, ICPSMAIN 
Containing Module: ICPCMSG 
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ICP2011 SAME CHANNEL NUMBER SPECIFIED FOR CHPID xx AND yy 


Explanation: An existing entry for channel path xx contains the same channel 
number and channel set as the entry for channel path yy that you want to add or 
alter. | 


System Action: (1) If the input is from card-image macro instructions, IOCP deletes 
any channel path entries that were added from multiple definitions on the CHPID 
macro instructions. [OCP continues to check the syntax of the remaining macro 
instructions, but does not generate an IOCDS in storage and does not produce 
configuration reports. (2) If the input is from the console screen, the channel path is 
not added or altered. 


Programmer Response: (1) For input from card-image macro instructions, ensure 
that duplicate channel numbers and channel sets are not specified on the CHPID 
macro instructions. If xx and/or yy is X‘FF’, check the CHPID macro instructions 
that contain the characters ** instead of a chpid number. (2) For input from the 
console screen, use the display, alter, and delete functions to check and correct the 
channel path entries. 


Detecting Module: ICPCIOCP 
Issuing Module: ICPCARDS, ICPSMAIN 
Containing Module: ICPCMSG 


ICP2021 CHPID xx HAS NOT BEEN DEFINED OR IS INVALID 


Explanation: You have requested a swap, display, delete, or alter function for a 
channel path:(xx) that does not exist in the IOCDS in storage; or you entered an 
invalid channel path identifier; or an entry for a control unit to be added specifies a 
channel path (xx) that does not exist in the IOCDS or is invalid. 


System Action: (1) If the input is from card-image macro instructions, [OCP does 
not add the control unit entry. IOCP continues to check the syntax of the remaining 
macro instructions, but does not generate an IOCDS in storage and does not 
produce configuration reports. (2) If the input is from the console screen, IOCP 
does not add the control unit entry or does not perform the requested channel path 
function. 


Programmer Response: (1) For input from card-image macro instructions, ensure 
that the channel path is valid and has been previously defined on a CHPID macro 
instruction before it is specified on a CNTLUNIT macro instruction. (2) For input 
from the console screen, use the display, alter, and delete functions to check and 
correct the channel path or control unit entry. 


Detecting Module: ICPCIOCP, ICPSMINT 
Issuing Module: ICPCARDS, ICPSMAIN 
Containing Module: ICPCMSG 


ICP2031 CHPID xx DOES NOT SUPPORT BYTE MULTIPLEXING 
OPERATIONS 


Explanation: An entry to be added for channel path xx has specified byte 
multiplexer operation. Byte multiplexer cannot be specified for this channel path. 
Up to four channel paths per side can be specified as byte multiplexer. On the A 
side, the channel paths must be in the ranges of 00 through 03 and 10 through 13 
(hex). On the B side, the channel paths must be in the ranges of 40 through 43 and 
50 through 53 (hex). 
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System Action: (1) If the input is from card-image macro instructions, IOCP does 
not add the channel path, and deletes any channel path entries that were added from 
multiple definitions on the CHPID macro instructions. [OCP continues to check the 
syntax of the remaining macro instructions, but does not generate an IOCDS in 
storage and does not produce configuration reports. (2) If the input is from the 
console screen, IOCP does not add the entry. 


Programmer Response: (1) For input from card-image macro instructions, ensure 
that the CHPID macro instructions are correctly specified. (2) For input from the 
console screen, use the display, alter, and delete functions to check and correct the 
channel path entries. 


Detecting Module: ICPCIOCP 

Issuing Module: ICPCARDS, ICPSMAIN 

Containing Module: ICPCMSG 

ICP2041 ALTER NOT VALID. CONTROL UNIT xxx CANNOT BE ON A 
BYTE CHANNEL 


Explanation: You requested, with the alter channel path function, that IOCP 
change the channel path from block to byte multiplexer. One or more shared 
control units (SHARED = Y/YB) or one or more data streaming control units 
(PROTOCL =S) are attached to the channel path. Shared and data streaming 
control units cannot be attached to byte multiplexer channel paths. Control unit xxx 
is the first shared or data streaming control unit that IOCP detected on the channel 
path. 


System Action: [OCP does not alter the channel path entry. 


IOCP Operator Response: Use the display and alter functions to check and correct 
the channel path or control unit entries. 


Detecting Module: [CPCIOCP 

Issuing Module: ICPSMAIN 

Containing Module: ICPCMSG 

ICP205I ALTER NOT VALID. BYTE CHANNEL CAN’T INHIBIT TIMEOUT 
FOR DEVICE xxx 


Explanation: For the alter channel path function, you requested that the channel 
path be changed from block to byte multiplexer. One or more I/O devices specified 
with TIMEOUT =N (timeout inhibited) are assigned to the channel path. 
TIMEOUT =N is not valid for I/O devices that are assigned to byte multiplexer 
channel paths. On the channel path, device xxx is the first detected I/O device with 
TIMEOUT =N specified. 


System Action: [OCP does not alter the channel path entry. 


IOCP Operator Response: Use the display and alter functions to check and correct 
the channel path or I/O device entries. 


Detecting Module: ICPCIOCP 
Issuing Module: ICPSMAIN 
Containing Module: ICPCMSG 
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ICP220I CONTROL UNIT xxx PREVIOUSLY DEFINED 


Explanation: The user has defined a control unit (xxx) to be added to the IOCDS, 
but an entry for control unit xxx already exists in the IOCDS in storage. 


System Action: (1) If the input is from card-image macro instructions, IOCP does 
not add the control unit entry. IOCP continues to check the syntax of the remaining 
macro instructions, but does not generate an IOCDS in storage and does not 
produce configuration reports. (2) If the input is from the console screen, IOCP 
does not add the entry. 


Programmer Response: (1) For input from card-image macro instructions, ensure 
that duplicate control unit numbers are not specified on the CNTLUNIT macro 
instructions. (2) For input from the console screen, use the display, alter, and delete 
functions to check and correct the control unit entries. 


Detecting Module: I[CPCIOCU 
Issuing Module: ICPCARDS, ICPSMAIN 
Containing Module: ICPCMSG 


ICP2211 MAXIMUM NUMBER OF CONTROL UNITS EXCEEDED 


Explanation: An entry for a control unit to be added exceeds the maximum number 
of control units allowed by IOCP. The maximum is 768. (The maximum of 768 is 
for both the A and B sides combined; the actual number allowed on your system 
might be less.) 


System Action: (1) If the input is from card-image macro instructions, IOCP does 
not add the control unit. [OCP continues to check the syntax of the remaining 
macro instructions, but does not generate an IOCDS in storage and does not 
produce configuration reports. (2) If the input is from the console screen, IOCP 
does not add the control unit entry. 


Programmer Response: Check your I/O configuration listing and reports to ensure 
control units are correctly defined. (1) For input from card-image macro 
instructions, ensure that the CNTLUNIT macro instructions are specified correctly. 
(2) For input from the console screen, use the display, alter, and delete functions to 
check and correct the control unit entries. 


Detecting Module: ICPCIOCU 
Issuing Module: ICPCARDS, ICPSMAIN 
Containing Module: ICPCMSG 


ICP2221 DUPLICATE CHPID NUMBERS SPECIFIED 


Explanation: An entry for a control unit to be added contains duplicate channel 
path identifiers. 


System Action: (1) If the input is from card-image macro instructions, IOCP does 
not add the entry. IOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an IOCDS in storage and does not produce 
configuration reports. (2) If the input is from the console screen, IOCP does not add 
the entry. 


Programmer Response: (1) For input from card-image macro instructions, ensure 
that channel path identifiers are not duplicated on the CNTLUNIT macro 
instruction. (2) For input from the console screen, enter the correct channel path 
identifiers. 
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Detecting Module: ICPCIOCU 
Issuing Module: I[CPCARDS, ICPSMAIN 
Containing Module: ICPCMSG 


ICP2231 NEITHER DATA STREAMING NOR SHARED C.U. ALLOWED ON 
BYTE CHANNEL(S) 


Explanation: An entry for a shared control unit or a data streaming control unit 
cannot be added because it specifies one or more byte multiplexer channel paths. 
Shared or data streaming control units cannot be attached to byte multiplexer 
channels. 


System Action: (1) If the input is from card-image macro instructions, IOCP does 
not add the control unit entry. IOCP continues to check the syntax of the remaining 
macro instructions, but does not generate an IOCDS in storage and does not 
produce configuration reports. (2) If the input is from the console screen, IOCP 
does not add the control unit entry. 


Programmer Response: (1) For input from card-image macro instructions, ensure 
that shared or data streaming control units are not specified for byte multiplexer 
channel paths. (2) For input from the console screen, use the display, alter, add, and 
delete functions to check and correct the control unit entry. 


Detecting Module: ICPCIOCU 
Issuing Module: [CPCARDS, ICPSMAIN 
Containing Module: ICPCMSG 


ICP2241 UNIT ADDRESS SETS EITHER OVERLAP/GENERATE HEX 
ADDRESS FF 


Explanation: An entry for a control unit to be added contains an invalid unit 
address for a device. The unit address (with the number of addresses) either exceeds 
hexadecimal X‘FF’ or duplicates another unit address. 


System Action: (1) If the input is from card-image macro instructions, IOCP does 
not add the entry. JOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an IOCDS in storage and does not produce 
configuration reports. (2) If the input is from the console screen, [OCP does not add 
the entry. 


Programmer Response: (1) For input from card-image macro instructions, ensure 
that the unit addresses specified on the UNITADD parameter are correctly specified. 
(2) For input from the console screen, use the display, alter, and add functions to 
check and correct the unit addresses. 


Detecting Module: [CPCIOCU, ICPCIODV 
Issuing Module: ICPCARDS, ICPSMAIN 
Containing Module: ICPCMSG 
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ICP225I CONTROL UNIT NUMBER xxx HAS NOT BEEN DEFINED 


Explanation: Either an entry for control unit xxx that you have attempted to 
display, alter, or delete does not exist in the IOCDS in storage, or an entry for an 
I/O device to be added specifies a control unit number (xxx) that has not been 
previously defined. 


System Action: (1) If the input is from card-image macro instructions, IOCP does 
not add the I/O device entry. IOCP continues to check the syntax of the remaining 
macro instructions, but does not generate an IOCDS in storage and does not 
produce configuration reports. (2) If the input is from the console screen, IOCP 
does not add the I/O device entry or does not perform the requested control unit 
function. 


Programmer Response: (1) For input from card-image macro instructions, ensure 
that the control unit has been previously defined on a CNTLUNIT macro 
instruction before the control unit number is used on the IODEVICE macro 
instruction. (2) For. input from the console screen, use the add, display, alter, and 
delete functions to check and correct the control unit or I/O device entry. 


Detecting Module: ICPCIOCU, ICPCIODV 
Issuing Module: ICPCARDS, ICPSMAIN 
Containing Module: ICPCMSG 


ICP2261 ALTER NOT VALID. DEVICE xxx REQUIRES EXISTING 
PROTOCOL/TYPE 


Explanation: For the alter control unit function, you requested that the protocol or 
type (SHARED =Y, YB, or N) values be changed for the control unit. One or more 
I/O devices assigned to the control unit are also assigned to other control units. Ifa 
device is assigned to more than one control unit, all control units that recognize the 
device must use the same protocol and type (shared) values. Device xxx is the first 
detected device assigned to the control unit. 


System Action: IOCP does not alter the control unit entry. 


IOCP Operator Response: (1) Use the display function to check the control unit or 
I/O device entries. (2) Use the delete function or alter I/O device function to remove 
I/O device(s) from the control unit. (3) Alter the control unit’s protocol/type. (4) Use 
the add I/O device function to replace the deleted I/O device(s), or the alter I/O 
device function to add the deleted control unit path(s). 


Detecting Module: ICPCIOCU 

Issuing Module: ICPSMAIN 

Containing Module: [CPCMSG 

ICP2271 ALTER NOT VALID. DEVICE xxx REQUIRES A REMOVED UNIT 
ADDRESS 


Explanation: For the alter control unit function, you requested the removal of one 
or more unit addresses from the control unit entry. One or more I/O devices 
assigned to the control unit have unit address(es) you are attempting to remove. 
Device xxx is the first detected I/O device assigned to the control unit. 


System Action: IOCP does not alter the control unit entry. 
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IOCP Operator Response: Use the display and alter functions to check and correct 
the control unit or I/O device entries. If you are removing devices from the control 
unit, remove the unit addresses or control unit identifier from the I/O device entries 
first, and then remove the unit addresses from the associated control unit entry. 


Detecting Module: ICPCIOCU 
Issuing Module: ICPSMAIN 
Containing Module: ICPCMSG 


ICP2281 CHPID xx DOES NOT SUPPORT 4.5 MB DATA STREAMING 


Explanation: A control unit with PROTOCL =S4 has a path to chpid number xx, 
but xx does not support 4.5 megabyte data streaming. On a processor that is not a 
Model X, the only channel path identifiers that do support 4.5 megabyte data 
streaming are: 06, 07, 16, 17, 26, 27, 46, 47, 56, 57, 66, and 67. 


System Action: (1) If the input is from card-image macro instructions, [OCP does 
not add the entry. IOCP continues to check the syntax of remaining LOCP macro 
instructions. (2) If the input is from the console screen, [OCP neither adds nor alters 
the entry. 


Programmer Response: (1) For input from card-image macro instructions, make 
sure the control unit is attached to the correct channel paths. (2) For input from the 
console, use the Display, Alter, and Add functions to check and correct the control 
unit entry. 


Detecting Module: ICPCIOCU 
Issuing Module: ICPCARDS, ICPSMAIN 
Containing Module: [CPCMSG 


1CP2291 MAX # OF CHPID’S PER DSE WITH 4.5 MB CU’S ATTACHED 
HAS BEEN EXCEEDED 


Explanation: IOCP has detected that the maximum number of channel paths per 
DSE that can attach to 4.5 megabyte control units on a Model X processor has been 
exceeded. On a Model X processor, IOCP allows a maximum of two channel paths 
per DSE to attach to control units that have PROTOCL = S4. 


System Action: (1) If the input is from card-image macro instructions, [OCP does 
not add the entry. [OCP continues to check the syntax of remaining IOCP macro 
instructions. (2) If the input is from the console screen, IOCP neither adds nor alters 
the entry. 


Programmer Response: (1) For input from card-image macro instructions, make 
sure the control unit is attached to the correct channel paths. (2) For input from the 
console, use the Display, Alter, and Add functions to check and correct the control 
unit entry. 


Detecting Module: ICPCIOCU 
Issuing Module: ICPCARDS, ICPSMAIN 
Containing Module: ICPCMSG 
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ICP2401 1/0 DEVICE nnn PREVIOUSLY DEFINED 


Explanation: An entry for an I/O device to be added already exists in the IOCDS in 
storage for I/O device nnn. 


System Action: (1) If the input is from card-image macro instructions, IOCP does 
not add the I/O device entry and deletes any I/O device entries that were added from 
multiple definitions on the IODEVICE macro instruction. IOCP continues to check 
the syntax of the remaining macro instructions, but does not generate an IOCDS in 
storage and does not produce configuration reports. (2) If the input is from the © 
console screen, IOCP does not add the entry. 


Programmer Response: (1) For input from card-image macro instructions, ensure 
that duplicate I/O device numbers/addresses are not specified on the IODEVICE 
macro instructions. (2) For input from the console screen, use the display, alter, and 
delete functions to check and correct the I/O device entries. 


Detecting Module: ICPCIODV 
Issuing Module: ICPCARDS, ICPSMAIN 
Containing Module: ICPCMSG 


ICP2411 MAXIMUM NUMBER OF I/O DEVICES EXCEEDED 


Explanation: An entry for an I/O device to be added exceeds the maximum number 
of I/O devices allowed. The maximum is 4080. 


System Action: (1) If the input is from card-image macro instructions, IOCP does 
not add the I/O device entry and deletes any I/O device entries that were added from 
multiple definitions on the IODEVICE macro instruction. IOCP continues to check 
the syntax of the remaining macro instructions, but does not generate an IOCDS in 
storage and does not produce configuration reports. (2) If the input is from the 
console screen, IOCP does not add the entry. 


Programmer Response: Check your I/O configuration to ensure that I/O devices are 
correctly defined. (1) For input from card-image macro instructions, ensure that the 
IODEVICE macro instructions are correctly specified. (2) For input from the 
console screen, use the display, alter, and delete functions to check and correct the 
I/O device entries. | 


Detecting Module: ICPCIODV 
Issuing Module: ICPCARDS, ICPSMAIN 


_ Containing Module: ICPCMSG 


ICP242I DUPLICATE CONTROL UNIT NUMBERS SPECIFIED 


Explanation: An entry for an I/O device to be added contains duplicate control unit 
numbers. 


System Action: (1) If the input is from card-image macro instructions, IOCP does 
not add the entry. IOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an IOCDS in storage and does not produce 
configuration reports. (2) If the input is from the console screen, IOCP does not add 
the entry. 


‘Programmer Response: (1) For input from card-image macro instructions, ensure 


that control unit numbers are not duplicated on the IODEVICE macro instruction. 
(2) For input from the console screen, enter the correct control unit numbers. 


Detecting Module: ICPCIODV 


IOCP User’s Guide and Reference 


Issuing Module: ICPCARDS, ICPSMAIN 
Containing Module: [CPCMSG 


ICP2431 TIMEOUT IS INVALID FOR BYTE CHANNEL (CHPID xx) 


Explanation: TIMEOUT =N is specified for one or more I/O devices that are 
assigned to a byte multiplexer channel path, TIMEOUT =N is not valid for I/O 
devices assigned to byte multiplexer channel paths. CHPID xx is the first detected 
byte multiplexer channel path to which the device(s) are assigned. 


System Action: (1) If the input is from card-image macro instructions. IOCP does 
not add the entry. IOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an IOCDS in storage and does not produce 
reports. (2) If the input is from the console screen, IOCP does not add or alter the 
I/O device entry. 


Programmer Response: (1) For input from card-image macro instructions, ensure 
that TIMEOUT =N is not specified on the IODEVICE macro instruction(s) for I/O 
devices assigned to byte multiplexer channel paths. (2) For input from the console 
screen, use the display, add, and alter functions to check and correct the channel 
path or I/O device entries. 


Detecting Module: ICPCIODV 

Issuing Module: ICPCARDS, ICPSMAIN 

Containing Module: ICPCMSG 

ICP244I SPECIFIED UNIT ADDRESS DOES NOT EXIST IN CONTROL 
UNIT nnn 


Explanation: A unit address for an I/O device to be added does not exist in the 
range of unit addresses for control unit nnn. 


System Action; (1) If the input is from card-image macro instructions, IOCP does 
not add the entry and deletes any I/O device entries that were added from multiple 
definitions on the IODEVICE macro instruction. IOCP continues to check the 
syntax of the remaining macro instructions, but does not generate an IOCDS in 
storage and does not produce configuration reports. (2) If the input is from the 
console screen, IOCP does not add the entry. 


Programmer Response: (1) For input from card-image macro instructions, ensure 
that the correct range of unit addresses is specified on the CNTLUNIT macro 
instruction and the IODEVICE macro instruction. (2) For input from the console 
screen, use the display, alter, and delete functions to check and correct the control 
unit and I/O device entries. 


Detecting Module: ICPCIODV 
Issuing Module: ICPCARDS, ICPSMAIN 
Containing Module: ICPCMSG 


ICP245I 1/O DEVICE nnn HAS NOT BEEN DEFINED 


Explanation: The entry for I/O device nnn that you have attempted to display, alter, 
or delete does not exist in the IOCDS in storage. 


System Action: None. 


Programmer Response: Ensure that the I/O device you have specified is correct and 
that you are using the correct function. 
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Detecting Module: ICPCIODV 
Issuing Module: ICPSMAIN 
Containing Module: ICPCMSG 


ICP2461 PROTOCOL/TYPE FOR ATTACHED CONTROL UNITS IS 
INCONSISTENT 


Explanation: An entry for an I/O device to be added has specified two or more 
control units and the control units do not have the same protocol or are not the 
same type (shared, shared block, or nonshared). 


System Action: (1) If the input is from card-image macro instructions, IOCP does 
not add the entry. IOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an IOCDS in storage and does not produce 
configuration reports. (2) If the input is from the console screen, IOCP does not add 
the entry. 


Programmer Response: (1) For input from card-image macro instructions, ensure 
that the control units are correctly specified on the CNTLUNIT macro instructions 
and that the I/O device is correctly specified on the IODEVICE macro instruction. 
(2) For input from the console screen, use the display, alter, and delete functions to 
check and correct the control unit and I/O device entries. 


Detecting Module: ICPCIODV 
Issuing Module: ICPCARDS, ICPSMAIN 
Containing Module: ICPCMSG 


ICP2471 1/0 DEVICE CONNECTED TO MORE THAN ONE CU ON SAME 
CHPID 


Explanation: An entry for an I/O device to be added has specified two or more 
control units and two or more of the control units are attached to the same channel 
path. When a device is assigned to more than one control unit, each control unit 
must be attached to a different channel path. 


System Action: (1) If the input is from card-image macro instructions, IOCP does 
not add the entry. IOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an IOCDS in storage and does not produce 
configuration reports. (2) If the input is from the console screen, IOCP does not add 
the entry. 


Programmer Response: (1) For input from card-image macro instructions, ensure 
that the control units are correctly specified on the CNTLUNIT macro instructions 
and that the I/O device is correctly specified on the IODEVICE macro instruction. 
(2) For input from the console screen, use the display, alter, and delete functions to 
check and correct the control unit and I/O device entries. 


Detecting Module: ICPCIODV 
Issuing Module: ICPCARDS, ICPSMAIN 
Containing Module: ICPCMSG 
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ICP2481 NO PATH TO CHPID nn FOR THE DEVICE(S) 


Explanation: JOCP did not find a path from the device(s) to the channel path that 
was specified by the PATH value on the IODEVICE macro instruction. 


System Action: IOCP continues to check the syntax of the remaining macro 
instructions but does not generate an IOCDS in storage and does not produce 
configuration reports. 


Programmer Response: Ensure that the value specified on the PATH parameter is 
correct. Check the associated CNTLUNIT and CHPID macro instructions to 
ensure that there is a path from the device(s) through a control unit to the specified 
channel path. 


Detecting Module: ICPCIODV 
Issuing Module: ICPCARDS, ICPSMAIN 
Containing Module: ICPCMSG 


ICP3001 MINIMUM CONFIGURATION WAS NOT DEFINED 


Explanation: To generate an IOCDS, you must define at least one I/O device that 
connects to a control unit connected to a channel path. In addition, the device must 
be either a card reader or magnetic tape. 


System Action: [OCP does not complete the generation of an IOCDS in storage. 

Programmer Response: Ensure that a minimum configuration is defined. 

Detecting Module: ICPCGNDS 

Issuing Module: ICPCARDS, ICPCRPT, ICPSMAIN 

Containing Module: ICPCMSG 

ICP3011 MORE THAN 4 BYTE MULTIPLEXOR CHANNELS HAVE BEEN 
DEFINED 


Explanation: [OCP has found more than 4 channel paths defined as byte 
multiplexer (TYPE =BY on CHPID macro instruction). 


System Action: IOCP does not complete the generation of an IOCDS in storage. 


Programmer Response: Ensure that not more than 4 channel paths are specified as 
byte multiplexer. 


Detecting Module: ICPCGNDS 
Issuing Module: ICPCARDS, ICPCRPT, ICPSMAIN 
Containing Module: ICPCMSG 


ICP3021 CHANNEL NUMBER ASSIGNMENT IS NOT CONTIGUOUS 


Explanation: Within a channel set (0 or 1), IOCP found that the assigned channel 
numbers were not consecutive. 


System Action: IOCP does not complete the generation of an IOCDS in storage. 


Programmer Response: Ensure that the assigned channel numbers within a channel 
set are consecutive. 


Detecting Module: ICPCGNDS 
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Issuing Module: ICPCARDS, ICPCRPT, ICPSMAIN 

Containing Module: ICPCMSG 

ICP3031 THIS CONFIGURATION EXCEEDS AVAILABLE SYSTEM 
STORAGE 


Explanation: On each side, IOCP cannot allocate storage for more than 4608 
control blocks for devices. (A control block represents a single path to a device; 
thus, a device can have up to four control blocks.) To determine the number of 
control blocks, IOCP performs the following two steps. 


1. For each 370 channel set (0 and 1) on each side, IOCP makes two calculations: 


a. Adds 17 to the number of control blocks. (For devices connected to a 
nonshared control unit (SHARED =N), IOCP generates one control block 
per channel path for each device. For devices connected to a shared control 
unit (SHARED = Y|YB), IOCP generates only one control block per channel 
path for all the devices connected to that shared control unit.) 


b. Adds 17 to the product of the number of byte multiplexer channels 
multiplied by 256. 


2. The larger result (a or b) found in Step | for channel set 0 is added to the larger 
result found in Step | for channel set 1. 


IOCP issues this error message if the sum found in 
Step 2 exceeds 4608 for either side. 


System Action: ITOCP does not complete the generation of an IOCDS in storage. 


Programmer Response: Change your I/O configuration so it requires fewer than 
4608 control blocks per side. 


Detecting Module: ICPCGNDS 

Issuing Module: ICPCARDS, ICPCRPT, ICPSMAIN 

Containing Module: ICPCMSG 

ICP3041 DUPLICATE UNIT ADDRESS xx IN CHPID zz - CONTROL UNIT 
SPECIFICATION 


Explanation: When processing control unit entries, IOCP detected unit address xx 
duplicated on channel path zz. This error can occur if a unit address is assigned to 
two or more control units and the control units are attached to the same channel 
path. 


System Action: IOCP does not complete the generation of an IOCDS in storage. 


Programmer Response: Ensure that unit addresses are not duplicated on 
CNTLUNIT macro instructions for a specified channel path. 


Detecting Module: ICPCGNDS 
Issuing Module: ICPCARDS, ICPCRPT, ICPSMAIN 
Containing Module: ICPCMSG 
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ICP3051 DUPLICATE UNIT ADDRESS xx IN CHPID zz - 1/0 DEVICE 
SPECIFICATION 


Explanation: When processing I/O device entries, LOCP detected unit address xx 
duplicated on channel path zz. This error can occur if two or more devices with the 
same unit address are assigned to the same control unit. 


System Action: IOCP does not complete the generation of an IOCDS in storage. 


Programmer Response: Ensure that unit addresses are not duplicated on 
CNTLUNIT or IODEVICE macro instructions for a specified channel path. 


Detecting Module: ICPCGNDS 
Issuing Module: ICPCARDS, ICPCRPT, ICPSMAIN 
Containing Module: ICPCMSG 


ICP306I1 1/0 DEVICE xxx IS CONNECTED TO MORE THAN 4 CHPIDS 


Explanation: IJOCP has found that I/O device xxx, which is connected to one or 
more control units, is assigned to more than 4 channel paths. A device can only be 
assigned to a combined maximum of 4 channel paths. 


System Action: IOCP does not complete the generation of an IOCDS in storage. 


Programmer Response: Ensure that an I/O device is not assigned to more than 4 
channel paths. 


Detecting Module: ICPCGNDS 
Issuing Module: ICPCARDS, ICPCRPT, ICPSMAIN 
Containing Module: ICPCMSG 


ICP3071 MORE THAN 16 CONTROL UNITS ASSIGNED TO CHPID zz 


Explanation: IOCP has found more than 16 control units assigned to channel path 
zz. You can assign a maximum of 16 control units to one channel path. 


System Action; [OCP does not complete the generation of an IOCDS in storage. 


Programmer Response: Ensure that not more than 16 control units are assigned to 
one channel path. 


Detecting Module: ICPCGNDS 

Issuing Module: ICPCARDS, ICPCRPT, ICPSMAIN 

Containing Module: ICPCMSG 

ICP3081 MAXIMUM NUMBER OF LOGICAL CONTROL UNITS 
EXCEEDED 


Explanation: IOCP tried to generate more than 256 logical control units. A logical 
control unit is built for (1) each control unit with no devices or no devices shared 
with other control units, and (2) each group of two to four control units that share 
devices between them. 


System Action: IOCP does not complete the generation of an IOCDS in storage. 


Programmer Response: Ensure that the configuration will not exceed 256 logical 
control units. You may need to reduce the number of control units and/or have 
more control units share devices. (The total number of channel paths for a logical 
control unit cannot exceed four.) | 
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Detecting Module: ICPCGNDS 
Issuing Module: ICPCARDS, ICPCRPT, ICPSMAIN 
Containing Module: I[CPCMSG 


ICP3091 DEVICE COUNT (xxxx) PLUS LOGICAL C.U. COUNT (yyy) 
EXCEEDS 4096 


Explanation: The sum of the number of I/O devices (xxxx) plus the number of 
logical control units (yyy) is greater than 4096, the maximum combined total that 
the processor can handle in 370-XA mode. 


System Action: IOCP does not complete the generation of an IOCDS in storage. 


Programmer Response: Reduce the number of devices and/or the number of logical 
control units. 


Detecting Module: ICPCGNDS 
Issuing Module: ICPCARDS, ICPCRPT, ICPMAIN 
Containing Module: ICPCMSG 


ICP3101 LOGICAL CONTROL UNIT SPEC. ERROR FOUND WHILE 
PROCESSING C.U. nnn 


Explanation: (1) IOCP found a specification error while building a logical control 
unit. A logical control unit can have a maximum of four channel paths. The logical 
control unit containing control unit nnn exceeds this maximum. (2) IOCP attempted 
to assign a physical control unit to two logical control units. A logical error has 
occurred in IOCP. 


System Action: IOCP does not complete the generation of an IOCDS in storage. 


Programmer Response: (1) If the logical control unit that contains control unit nnn 
has four or fewer control units, then reduce the number of channel paths. If the 
logical control unit that contains control unit nnn has more than four control units, 
reduce the number to four or fewer by changing the way devices are shared between 
control units. (2)Analyze the logical control unit that contains the physical control 
unit. If the logical control unit is valid, save the console sheet and all associated 
output and notify the system programmer. 


Detecting Module: ICPCGNDS 
Issuing Module: ICPCARDS, ICPCRPT, ICPSMAIN 
Containing Module: ICPCMSG 


ICP400I READ/WRITE OF IOCDS IS INVALID ON THIS PROCESSOR 


Explanation: (1) An option to print a report of an IOCDS or to write an IOCDS 
was specified but running ICPIOCP (MVS) or specifying 308X for the IOCP 
command processor option (VM) only reads or writes an IOCDS for a 308X or a 
908X processor. (2) IOCP issued the MSSFCALL SVC (SVC 122) and received a 
return code of 12. This indicates that the MSSFCALL SVC is not available on the 
processor. 


System Action: IOCP issues message ICPO5SII and terminates. 
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Programmer Response: (1) If you are verifying an input deck perform one of the 
following and run the job again: 


¢ For MVS, omit the WRTCDS and REPORT options on the PARM parameters 
of the EXEC statements. 


¢ For VM, enter the 308X processor option and omit the configuration report and 
IOCDS generation options in the IOCP command. 


If you want to read or write an JOCDS, you must use the IJOCP that is for your 
processor complex. (2) Rerun the job on a processor that recognizes the 
MSSFCALL SVC, 


Problem Determination: Related message ICP051I indicates the function IOCP 
attempted. 


Detecting Module: ICPCRTNS, ICPPCNTL 
Issuing Module: ICPPCNTL 
Containing Module: ICPCMSG 


ICP4011 IOCDS ACCESS PROBLEM. RETURNED RC =4 x TIMES AND/OR 
RC=8 y TIMES 


Explanation: JOCP has issued the MSSFCALL SVC (SVC 122) nine times and has 
received x number of return codes of 4 and y number of return codes of 8. Return 
code 4 indicates that the processor controller is temporarily busy: return code 8 
indicates that one of the MSSFCALL SVC control blocks (MSFCB or MSFAB) is 
in use. 


System Action: IOCP issues message ICPO51] and terminates. 


Programmer Response: Rerun the job. If the problem occurs again, notify your 
system programmer. 


Problem Determination: Related message ICPOS5II indicates the function IOCP 
attempted. 


Detecting Module: ICPCRTNS, ICPPCNTL 
Issuing Module: ICPPCNTL 
Containing Module: ICPCMSG 


ICP4021 MSSFCALL RETURNED AN UNEXPECTED RESPONSE CODE OF 
xxxx HEX 


Explanation: [OCP received an unexpected response from the MSSFCALL SVC 
(SVC 122). Bytes 6 and 7 of the response field in the MSSFCALL data block are 
indicated by xxxx (hex). IOCP was attempting to read or write an IOCDS. 


System Action: IOCP terminates the read or write operation. 


Programmer Response: Rerun the job. If the problem occurs again and the 
response is X‘xx40’ (indicates a processor controller warm start or hardware failure), 
notify your customer engineer. If the problem occurs again and the response is 
X‘xxFO’ (where xx is anything other than 41, 42, 43, 44, 45, or 46) or X‘xx00’, notify 
the next level of support. . 
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Problem Determination: 


1. A response of X‘41F0’ can occur when more than one user or job tries to access 
an IJOCDS concurrently, or if the data set is not open for a read or write, or if 
PROTOCL = S4 was specified in a CNTLUNIT macro instruction and your 
processor has not been upgraded to support a data rate of 4.5 megabytes. 


iw) 


. A response of X‘42F0’ indicates that the IOCDS you want to read or write is 
not valid on this processor complex. The response can also occur if the ability 
to write to the IOCDS is not supported on your processor complex. 


3. For a processor complex that is partitioned, a response of X‘43F0’ occurs if you 
specify a dual write or if you try to read/write an IOCDS in the other partition. 


4. If the processor complex is configured as a multiprocessor and you try to read 
an IOCDS or do a dual write, the following responses may occur: X‘44F0’ if 
the A side processor controller file (contains the I/O configuration data sets) is 
in diagnostic mode; X‘*45F0’ if the B side processor controller file is in diagnostic 
mode. 


5. A response of X‘46F0’ indicates that the IOCDS(s) you attempted to write to is 
write-protected. Use the IOCDSM (SYS021) frame to remove the 
write-protection. Then rerun the job. 


If the problem was with a read or a write, system product users can refer to message 
ICPOSII for more information on which IOCDS caused the problem. 


If you are running the VM version of IOCP, see the IOCP Command Usage Notes 
in Chapter 3, 


Detecting Module: ICPCWTDS, ICPCRDDS 
Issuing Module: ICPPCNTL, ICPSMAIN 
Containing Module: ICPCMSG 


ICP403I LEVEL nn IOCDS IS INVALID 


Explanation: IOCP received a response from the MSSFCALL SVC (SVC 122) 
where the response field in the MSSFCALL data block has byte 7 set to X‘20" and 
byte 6 bit 0 set to 1. This indicates that the IOCDS that IOCP is attempting to read 
is either being updated or was not closed after the last time it was written to. The 
IOCDS is considered invalid. 


System Action: [OCP terminates the read operation. 


Programmer Response: Rerun the job. If the error occurs again, notify your system 
programmer. 


Detecting Module: ICPCRDDS 
Issuing Module: ICPPCNTL, ICPSMAIN 
Containing Module: ICPCMSG 


ICP4041 LEVEL nn IOCDS DIRECTORY INVALID 


Explanation: [OCP has read an IOCDS from the processor controller into storage 
and compared the member names and sector sizes in the directory record against the 
expected values. The directory does not match the expected values. This message 
can occur when a 370 level IOCP tries to read a 370/370-XA IOCDS, or when a 
lower level 370/370-XA IOCP tries to read a 370/370-XA IOCDS generated by a 
higher level 370/370-XA IOCP. | | 
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System Action: IOCP terminates the read operation. 


Programmer Response: Rerun the job. If the problem occurs again, notify your 
system programmer. 


Detecting Module: ICPCRDDS 

Issuing Module: [CPPCNTL, ICPSMAIN 

Containing Module: ICPCMSG 

ICP501A TYPE “PRG”: PRESS “ALT”, “CMD” KEYS: TYPE “PRGATTN”: 
PRESS “ENTER”. 


Explanation: IOCP issues this message to instruct the IOCP operator how to enter 
program mode in order to operate IOCP. This message appeare after the operator 
has started or restarted IOCP. 


System Action: IOCP waits for an operator response. 
IOCP Operator Response: Perform the following steps: 
¢ To put the console in program mode, key in the following console command: 
PRG 


¢ Press and hold down the ALT key and then press the CMD key while holding 
down the ALT key. 


The following message is displayed: 
CONSOLE MODE CHANGED 


¢ To cause a program attention, key in the following console command: 
PRGATTN 


Press ENTER. 
IOCP displays the primary menu (Figure 4-4) and you can start operating IOCP. 


To take the console out of program mode after you have completed IOCP operation, 
key in FDC (frame dependent command), press and hold down the ALT key, and 
then press the CMD key while holding down the ALT key. 


Detecting Module: ICPSIO 

Issuing Module: ICPSMAIN 

Containing Module: ICPCMSG 

ICP502A INPUT NOT CORRECT OR MISSING AT CURSOR POSITION. 
PLEASE CORRECT. 


Explanation: You have entered invalid or incomplete data in the input field where 
the cursor is positioned. 


System Action: IOCP waits for an operator response. 

IOCP Operator Response: Enter valid data (at the cursor position), or a command. 
Detecting Module: ICPSMINT, ICPSSCAN 

Issuing Module: ICPSMAIN 

Containing Module: ICPCMSG 
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ICP503A MORE THAN ONE SELECTION ENTERED. ONLY ONE 
SELECTION ALLOWED. 


Explanation: On an add, alter, delete, or display selection menu, you have entered 
more than one entry. 


System Action: IOCP waits for an operator response. 


IOCP Operator Response: Make only one entry on the menu and try the function 
again, or enter a command. 


Detecting Module: ICPSMINT 
Issuing Module: ICPSMAIN 
Containing Module: ICPCMSG 


ICP504A_ NO SELECTION HAS BEEN MADE. PLEASE MAKE SELECTION. 


Explanation: On the add, alter, delete, or display selection menu, you have not 
made a correct entry. 


System Action: IOCP waits for an operator response. 

IOCP Operator Response: Key in a valid entry on the screen, or enter a command. 

Detecting Module: ICPSMINT 

Issuing Module: ICPSMAIN 

Containing Module: ICPCMSG | 

ICPS05A CARD INPUT ERROR(S) FOUND. CHECK PRINTER FOR 
LISTING. PROCEED. 


Explanation: IOCP has detected errors in the macro instructions read from the 
input device. The output listing shows the macro instructions read and indicates the 
errors detected. 


System Action: IOCP waits for an operator response. 


IOCP Operator Response: Correct the errors and try the function again, or enter a 
command. 


Detecting Module: ICPSMINT 

Issuing Module: ICPSMAIN 

Containing Module: ICPCMSG 

ICP5064 CARD INPUT ERROR(S) FOUND. NO PRINTER SPECIFIED - NO 
LISTING. PROCEED. 


Explanation: IOCP has detected errors in the macro instructions read from the 
input device. However, you have not specified a printer, so JOCP cannot indicate 
the errors detected. 


System Action: [OCP waits for an operator response. 


IOCP Operator Response: Try the menu function again and specify a printer to 
receive the output listing. The listing will indicate the errors detected. Correct the 
errors and try the function again, or enter a command. 


Detecting Module: ICPSMINT 
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Issuing Module: ICPSMAIN 

Containing Module: ICPCMSG 

ICP507A_ IOCDS GENERATION ERROR(S). CHECK PRINTER FOR 
LISTING. PROCEED. 


Explanation: IOCP has detected errors in the input macro instructions while 
generating an IOCDS in storage. The output listing shows the macro instructions 
read by IOCP and indicates the errors detected. 


System Action: IOCP waits for an operator response. 


IOCP Operator Response: Correct the errors in the input macro instructions and try 
the function again, or enter a command. 


Detecting Module: ICPSMINT 

Issuing Module: ICPSMAIN 

Containing Module: ICPCMSG 

ICP508A IOCDS GENERATION ERROR(S). NO PRINTER SPECIFIED - NO 
LISTING. PROCEED. 


Explanation: IOCP has detected errors in the input macro instructions while 
generating an IOCDS in storage. However, you have not specified a printer, so 
IOCP cannot indicate the errors detected. 


System Action: IOCP waits for an operator response. 


IOCP Operator Response: Try the menu function again and specify a printer to 
receive the output listing. The listing will indicate the errors detected. Correct the 
errors and try the function again, or enter a command. 


Detecting Module: ICPSMINT 

Issuing Module: ICPSMAIN 

Containing Module: ICPCMSG 

ICP5091 ENTRIES BEING PROCESSED. PLEASE WAIT FOR 
COMPLETION. 


Explanation: This message indicates that IOCP is processing the entries for the 
requested function. 


System Action: IOCP locks the keyboard until the function is complete. 
IOCP Operator Response: Wait for and respond to the next message. 
Detecting Module: ICPSMINT 

Issuing Module: ICPSMINT 

Containing Module: ICPCMSG 


ICPS5101 ENTRIES BEING PROCESSED. LISTING WILL BE PRINTED. 


Explanation: IOCP is processing the requested function and the function includes 
producing an output listing. 


System Action: IOCP locks the keyboard until the function is complete. 
IOCP Operator Response: Wait for and respond to the next message. 


Detecting Module: ICPSMINT 
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Issuing Module: ICPSMINT 
Containing Module: ICPCMSG 


ICPSi11 ENTRIES BEING PROCESSED. PRINTER NOT SPECIFIED. 


Explanation: IOCP is processing the entries for the requested function and, because 
a printer was not specified, the function does not include an output listing. 


System Action: IOCP locks the keyboard until the function is complete. 
IOCP Operator Response: Wait for and respond to the next message. 
Detecting Module: ICPSMINT 

Issuing Module: ICPSMINT 

Containing Module: ICPCMSG 


ICP512A PROCESSING COMPLETED. PROCEED. 


Explanation: IOCP has processed the data entered on the menu, completed the 
requested function, and detected no errors. 


System Action: IOCP waits for an operator response. 

IOCP Operator Response: Enter a command, or repeat the menu function. 

Detecting Module: ICPSMINT 

Issuing Module: ICPSMAIN 

Containing Module: ICPCMSG 

ICP513A PROCESSING COMPLETED. CHECK PRINTER FOR LISTING. 
PROCEED. 


Explanation: IOCP has processed the data entered on the menu, completed the 
requested function, and detected no errors. An output listing was produced. 


System Action: IOCP waits for an operator response. 

IOCP Operator Response: Enter a command, or repeat the menu function. 

Detecting Module: ICPSMINT 

Issuing Module: ICPSMAIN 

Containing Module: ICPCMSG 

ICP514A PROCESSING COMPLETED. NO PRINTER SPECIFIED - NO 
LISTING. PROCEED. 


Explanation: IOCP has processed the data entered on the menu, completed the 
requested function, and detected no errors. An output listing was not produced. 


System Action: IOCP waits for an operator response. 

IOCP Operator Response: Enter a command, or repeat the menu function. 
Detecting Module: ICPSMINT | 

Issuing Module: ICPSMAIN 

Containing Module: ICPCMSG 
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ICP515W IOCP TERMINATED. WAIT STATE CODE = B2x. 


Explanation: IOCP has loaded the PSW with a wait state code of B20 through B24. 
See “IOCP Wait State Codes” in Chapter 4 for an explanation of the wait state 
codes. 


System Action: [OCP terminates. 

IOCP Operator Response: See Chapter 4. 

Problem Determination: See Chapter 4. 

Detecting Module: ICPSACP 

Issuing Module: ICPSACP 

Containing Module: ICPSACP 

ICP516A ENTRY ON COMMAND LINE IS NOT CORRECT. RE-ENTER 
WITH CORRECTIONS. 


Explanation: The command you have entered is not a valid command for the menu 
being displayed. 


System Action: IOCP waits for an operator response. 


IOCP Operator Response: Key in a valid command (as shown on lines 20 and 21), 
or enter the required menu data. 


Detecting Module: ICPSBOTL, ICPSSCAN 

Issuing Module: ICPSMAIN 

Containing Module: ICPCMSG 

ICP517A ONLY ONE “=” DELIMITER IS PERMITTED. PLEASE 
CORRECT. 


Explanation: For a screen command in the form “command = value”, you have 
entered more than one “=” in the command. 


System Action: IOCP waits for an operator response. 

IOCP Operator Response: Correct the input and enter the screen command again. 

Detecting Module: [CPSSCAN 

Issuing Module: ICPSMAIN 

Containing Module: ICPCMSG 

ICPS518A VALUE AFTER “=” CONTAINS TOO MANY DIGITS. CHECK 
LENGTH & RE-ENTER. 


Explanation: For a screen command in the form “command = value”, you have 
entered too many digits for “value” in the command. 


System Action: IOCP waits for an operator response. 

IOCP Operator Response: Correct the input and enter the screen command again. 
Detecting Module: ICPSBOTL, ICPSSCAN 

Issuing Module: ICPSMAIN 

Containing Module: ICPCMSG 
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ICP519A VALUE AFTER “=” IS NOT VALID. HEX DIGITS ONLY. PLEASE 
CORRECT. 


Explanation: For a screen command in the form “command = value”, you have 
entered invalid digits for “value” in the command. Only hexadecimal digits (0 
through 9 and A through F) are valid on the command. 


System Action: IOCP waits for an operator response. 

IOCP Operator Response: Correct the input and enter the screen command again. 

Detecting Module: ICPSSCAN 

Issuing Module: ICPSMAIN 

Containing Module: ICPCMSG 

ICP521A NO VALUE ALLOWED WITH THIS COMMAND USING THIS 
MENU. PLEASE CORRECT. 


Explanation: You have entered a screen command in the form “command = value” 
on a menu that does not allow this form of command. A “command = value” form 
of screen command can only be entered on an add, alter, or display menu. 


System Action: IOCP waits for an operator response. 
IOCP Operator Response: Enter a valid command. 
Detecting Module: ICPSBOTL 

Issuing Module: ICPSMAIN 

Containing Module: ICPCMSG 


ICP522A VALUE MISSING AFTER “=” DELIMITER. ENTER A VALUE. 


Explanation: For a screen command in the form “command = value”, ou have not 
y 
entered any digits for “value” after the “=” in the command. 


System Action: IOCP waits for an operator response. 

IOCP Operator Response: Correct the input and enter the screen command again. 

Detecting Module: ICPSSCAN 

Issuing Module: ICPSMAIN 

Containing Module: ICPCMSG 

ICP523I SWAP REQUEST NOT VALID. BOTH CHPIDS MUST BE THE 
SAME CHANNEL TYPE. 


Explanation: You tried to swap two channel paths, but the channel paths are not 
the same type. The channel paths to be swapped must be the same type, either 
block or byte multiplexer. oo 


System Action: IOCP does not swap the channel paths and does not print 
configuration reports. 


IOCP Operator Response: Enter channel paths that are the same type. 
Detecting Module: ICPSMINT | 

Issuing Module: ICPSMAIN 

Containing Module: ICPCMSG 
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ICP550A_ ddd, INT REQ, CC=3/NO PATH AVAILABLE 


Explanation: IOCP received a “not operational” condition code, code 3, on the path 
specified. In the message, ddd indicates the device address/number of the device. 


System Action: JOCP waits for the operator to correct the entry or make the path 
available and try the operation again. 


IOCP Operator Response: (1) If the entry for the device was incorrectly specified on 
the screen, correct the entry and try the operation again. (2) If the path is not 
available, turn on the path to the device (such as setting the channel or control unit 
switch) and try the operation again. (3) If the path cannot be made available, run 
IOCP again using another device or path. 


Detecting Module: ICPSINIO, ICPSOTIO 
Issuing Module: ICPSMAIN 
Containing Module: ICPSINIO, ICPSOTIO 


ICP551A ddd, INTREQ,cm,stat,sense 


Explanation: JOCP detected a device that requires operator intervention. In the 
message text in hexadecimal, the fields are: 


ddd Device address/number. 


cm Operation code of the channel command word: (CCW) during whose 
execution the error occurred. If the channel command word cannot be found, 
this field appears as **. 


stat Status portion of the channel status word (CSW). 


sense The sense data can be up to 24 bytes long. The first two sense bytes are for 
the error condition. 


System Action: [OCP waits for the operator to end IOCP or try the operation 
again. 


IOCP Operator Response: Check the following and try the operation again. 


¢ Make the unit ready. If the unit cannot be made ready, run IOCP again using 
another device. 


¢ Feed more cards to the reader. 

e Clear a card jam. 

e Empty a stacker. 

¢ Put paper into the printer. 
Detecting Module: ICPSINIO, ICPSOTIO 
Issuing Module: ICPSMAIN 
Containing Module: ICPSINIO, ICPSOTIO 


ICP552A_ ddd,err,cm,stat,sense 


Explanation: An uncorrectable I/O error was detected by IOCP. Two consecutive 
commas or a blank field in the message text indicates that a field could not be 
determined. 
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In the message text, the fields are: 


ddd Device address/number in hexadecimal. 


err 


cm 


stat 


sense 


Description of the error based on status and sense information: 


BOC 
ccc 
fants 
CHC 


bus out check. 
channel control check. 
channel data check. 


chaining check. } 


CMD command reject. 


CPC 
DCK 
EQC 
ICC 
IOE 
OVR 
PRC 
SEN 


channel program check. 

data check. 

equipment check.. 

interface control check. 

input/output error (for errors other than those described). 
data overrun. - | 

channel protection check. 


a unit check occurred during a sense operation. (When this condition 
is present, the sense field does not appear in the message text.) 


Command code, in hexadecimal, of the channel command word (CCW) being 
executed when the error occurred. If the channel command word cannot be 
found, this field appears as +. 


Status portion, in hexadecimal, of the channel status word (CSW). 


The sense data can be up to 24 bytes long. The arse two sense bytes are for 
the error condition. . 


System Action: IOCP waits for the operator to try the operation again or end 


IOCP. 


IOCP Operator Response: Probable user or hardware error. Try another device on 
another channel. 


Possible values of the err field and appropriate responses are as follows: 


¢ CMD REJECT - Command reject. Check that device entries on the screen are 
correct. 


¢ BOC - bus out check. 


¢ EQC - equipment check. 


¢ ICC - interface control check. 


¢ OVR - data overrun 


These are permanent hardware faults. Customer engineer action is required. 
Detecting Module: ICPSINIO, ICPSOTIO 
Issuing Module: ICPSMAIN 
Containing Module: ICPSINIO, ICPSOTIO 
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ICP553A ddd, INT REQ, CC=3/NO PATH AVAILABLE 


Explanation: Before reading from an input device or writing to an output device, 
IOCP received a “not operational” condition code, code 3, on the path specified. In 
the message, ddd indicates the device address/number. 


System Action: IOCP waits for the operator to make the path available and signal 
IOCP by keying in “PRGATTN” on the command line and pressing ENTER. 


IOCP Operator Response: (1) If the path is not available, turn on the path to the 
device (such as setting the channel or control unit switch) and try the operation 
again. (2) If the path cannot be made available, run JOCP again using another path 
or device. 


Detecting Module: ICPSINIO, ICPSOTIO 
Issuing Module: ICPSINIO, ICPSOTIO 
Containing Module: ICPSINIO, ICPSOTIO 


ICP554A ddd, INTREQ,cm,stat,sense 


Explanation: Before reading from an input device or writing to an output device, 
IOCP detected a device that requires operator intervention. In the message text in 
hexadecimal, the fields are: 


ddd Device address/number. 


cm Operation code of the channel command word (CCW) during whose 
execution the error occurred. If the channel command word cannot be found, 
this field appears as **. 


stat Status portion of the channel status word (CSW). 


sense The sense data can be up to 24 bytes long. The first two sense bytes are for 
the error condition. | 


System Action: IOCP waits for the ee to key in “PRGATTN” on the 
command line and press ENTER. 


IOCP Operator Response: Check the following: 


* Make the unit ready. If the device cannot be made ready, run IOCP again using 
another device. 


¢ Feed more cards to the reader. 
¢ Clear.a card jam. 
e Empty a stacker. 
¢ Put paper into the printer. | 
Key in “PRGATTN” on the command line and press ENTER. 
Detecting Module: ICPSINIO, ICPSOTIO 
Issuing Module: ICPSINIO, ICPSOTIO 
Containing Module: ICPSINIO, ICPSOTIO 
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ICP555A ddd, err,cm,stat,sense 


Explanation: While reading from an input device or writing to an output device, 
IOCP detected an error that can be tried again or ignored. Two consecutive 
commas or a blank field in the message text indicates that the field could not be 
determined. 


In the message text, the fields are: 

ddd Device address/number in hexadecimal. 

err Description of the error based on status and sense information: 
DCK data check. 
EQC equipment check (card reader). 


cm Command code, in hexadecimal, of the channel command word (CCW) being 
executed when the error occurred. If the channel command word cannot be 
found, this field appears as **. 


stat Status portion, in hexadecimal, of the channel status word (CSW). 


sense The sense data can be up to 24 bytes long. The first two sense bytes are for 
the error condition. 


System Action: IOCP waits for the operator to signal IOCP to try the operation 
again by keying in “PRGATTN” on the command line and pressing ENTER. If the 
error occurred on the input device, IOCP tries the read operation again. If the error 
occurred on the output device, IOCP does not reprint the line. 


IOCP Operator Response: Have IOCP try the command again (by keying in 
“PRGATTN” on the command line and pressing ENTER), or rerun IOCP using 
another device. 


Detecting Module: ICPSINIO, ICPSOTIO 
Issuing Module: ICPSINIO, ICPSOTIO 
Containing Module: ICPSINIO, ICPSOTIO 


ICP556I = ddd,err,cm,stat,sense 


Explanation: While [OCP was reading from an input device or writing to an output 
device, an uncorrectable error was detected by IOCP. Two consecutive commas or a 
blank field indicates that a field could not be determined. 


In the message text, the fields are: 
ddd Device address/number in hexadecimal. 
err Description of the error based on status and sense information: 
BOC bus out check. 
CCC channel control check. 
CDC channel data check. 
CHC chaining check. 
CMD command reject. 
CPC channel program check. 
DCK data check. 
EQC equipment check. 
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ICC interface control check. 

IOE input/output error (for errors other than those described). 
OVR data overrun 

PRC _ channel protection check. 


REC record error. (The record read was not 80 bytes or a multiple of 80 
bytes.) 


SEN a unit check occurred during a sense operation. (When this condition 
is present, the sense field does not appear in the message text.) 


cm Command code, in hexadecimal, of the channel command word (CCW) being 
executed when the error occurred. If the channel command word cannot be 
found, this field appears as **. 


stat Status portion, in hexadecimal, of the channel status word (CSW). 


sense The sense data can be up to 24 bytes long. The first two sense bytes are for 
the error condition. 


System Action: [OCP terminates by loading a PSW with a wait state code of B23. 
Probable hardware error. (Try another device on another channel.) 


For a magnetic tape device, do not unconditionally accept the results of the 
operation. Check that the tape being used for this job has not been replaced or 
removed. Each message should be considered as a potential warning of a marginal 
condition. 


For a card reader, note that some abnormal error condition occurred. Depending 
on the severity of the error (check status and sense information) and depending on 
the installation requirements, take the appropriate action. 


Possible values of the err field and appropriate responses are as follows: 


¢ CMD REJECT - Command reject. Correct the command and try the function 
again. 


¢ BOC - bus out check. 

¢ EQC - equipment check. 

e ICC - interface control check. 

¢ OVER - data overrun 

These are permanent hardware faults. Customer engineer action is required. 

Detecting Module: ICPSINIO, ICPSOTIO 
Issuing Module: ICPSINIO, ICPSOTIO 
Containing Module: ICPSINIO, ICPSOTIO 
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IOCP Messages (DMSICP Prefix) 


The following messages are issued only by the VM version of IOCP. The messages 
are arranged in alphanumeric order by message identifier. 

The message format is: 

DMSICPnnnE text 


where: 


nnn is the message number 
text is the message text 
E is an action code that denotes an error. 


Note: The CMS-IOCP interface module, DMSICP, issues these error messages with 
corresponding return codes (RC) for each message. 
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DMSICP001E NO FILENAME SPECIFIED 


Explanation: The IOCP command requires that you specify the name of the file 
containing the source IOCP macro instructions or the name of the file to contain the 
IOCP output file. 


System Action: Execution of the command is terminated. The system status 
remains the same. RC=24 


User Response: Issue the command again and specify the filename of the IOCP 
input or output file. 
DMSICP002E FILE ‘filename IOCP’ NOT FOUND 


Explanation: The specified file was not found on the accessed disk(s). Either the 
file does not reside on this disk, the file identification was misspelled, or incomplete 
information was provided to cause the appropriate disk to be searched. 


System Action: Execution of the command is terminated. The system status 
remains the same. RC=28 


User Response: Find or create the desired file. To make sure that the file exists, 
issue either: 


STATE fn ft * or 
LISTFILE fn ft * 


Correct the command and issue it again. 


DMSICP003E INVALID OPTION ‘option’ 


Explanation: The specified option is invalid. (1) The option may have been 
misspelled. (2) If the option can be truncated, it may have been truncated 
improperly. (3) The option may conflict with another option in the command line. 


System Action: Execution of the command is terminated. The system status remains 
the same. RC=24 


User Response: Correct the command and issue it again. 


DMSICP006E NO READ/WRITE DISK ACCESSED 


Explanation: The user does not have access to a read/write disk on which the IOCP 
program can write its output file. 


System Action: Execution of the command is terminated. The system status 
remains the same. RC =36 


User Response: Access a read/write disk and issue the command again, or issue the 
CP LINK command to reset the A-disk to read/write mode. Access the A-disk 
again, and issue the command. 


DMSICP007E FILE ‘filename’ IOCP IS NOT FIXED, 80 CHAR. RECORDS 


Explanation: The specified file must have fixed length, 80-character records for the 
command to execute. 


System Action: Execution of the command is terminated. The system status 
remains the same. RC =32 
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User Response: It is possible that an incorrect file name was specified in the 
command line. In this case, issue the command again. If, however, the file name 
was correct but the file has the wrong format or does not contain 80-character 
records, change the file’s format and/or record length with the COPYFILE or 
XEDIT command. 


DMSICP038E FILEID CONFLICT FOR DDNAME ‘SYSIN’ 


Explanation: Either (1) the user issued a FILEDEF command for reader or tape 

input and the specified filename already exists on disk as fn IOCP, or (2) the user 
issued a FILEDEF command for input from disk with a filetype other than IOCP 
and there exists a file fn IOCP on this disk. 


System Action: Execution of the command is terminated. The system status 
remains the same. RC=40 


User Response: Check that you have specified the correct filename with the IOCP 
command. If it is correct, for the first explanation, issue a FILEDEF ddname 
CLEAR command for the file, or issue a FILEDEF command that sets the filetype 
correctly. For the second explanation, either use a different filename for the input 
file, or erase the existing disk file. 

DMSICPO070E INVALID PARAMETER ‘parameter’ 

Explanation: An invalid operand was specified in the command line. 


System Action: Execution of the command is terminated. The system status 
remains the same. RC=24 


User Response: Correct the command line and issue the command again. 


DMSICP075E DEVICE ‘devtyp’ INVALID FOR INPUT|OUTPUT 


Explanation: The device specified for the input ddname is invalid. This message 
appears if the input device specified is DUMMY, PRINTER, PUNCH or 
TERMINAL. 


System Action: Execution of the command is terminated. The system status 
remains the same. RC=40 


User Response: Issue the FILEDEF command again and specify the correct input 
device. 
DMSICP099E CMS/DOS ENVIRONMENT ACTIVE 


Explanation: The IOCP command cannot execute while the CMS/DOS environment 
is active. 


System Action: Execution of the command is terminated. The system status remains 
the same. RC=40 


User Response: Use the SET DOS command to deactivate the CMS/DOS 
environment. Then issue the [OCP command again. 
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Appendix A. Coding [OCP Macro Instructions 


This appendix describes the rules for coding IOCP card-image macro instructions 
and the notation used in this book to describe the macro instructions. 


Rules for Coding IOCP Macro Instructions 


The rules for coding IOCP macro instructions are those of the assembler language. 
The following paragraphs are a summary of these rules as stated in 
OS/VS-DOS/VS-VM/370 Assembler Language (GC33-4010; for 370 mode) and 
Assembler H Version 2 Application Programming Language Reference (GC26-4037; 
for both 370 mode and 370-XA mode). 


IOCP macro instructions have the following standard format: 


Name Operation Operand Comments 


Name symbolically identifies the macro instruction. If included, it can contain from 
one to eight alphanumeric characters, the first of which must be alphabetic. The 
name must begin in the first column of the macro instruction and must be followed 
by one or more blanks. The name field of an IOCP macro instruction is ignored by 
IOCP. 


Operation identifies the macro instruction. It must be preceded and followed by one 
or more blanks. The operation field can start in the second column of the macro 
instruction if the name field is not used. 


Operand contains parameters coded in any order and separated by commas. The 
operand field ends with one or more blanks placed after the last parameter. A 
parameter consists of a keyword followed by an equal sign (=) and the keyword 
value. The keyword value can be a single value (or subfield) or a list of values (or 
subfields). If the keyword value consists of more than one subfield, the subfields 
must be separated by commas and the list of subfields must be enclosed in 
parentheses. When a subfield contains multiple values (such as the UNITADD= 
subfield on the CNTLUNIT macro instruction), these subparameters are positional 
and must be coded in the order shown. The absence of a subparameter is indicated 
by a comma coded in its place. However, if the absent subparameter is the last one 
or if all following subparameters are also absent, do not code any commas to replace 
these subparameters. 


Comments can be written on an IOCP macro instruction, but they must be separated 
from the last parameter of the operand field by one or more blanks. You can use an 
entire card for a comment by placing an asterisk in the first column and the 
characters IOCP in columns 2 through 5 of each card. An * in column | ora .* in 
columns | and 2 are also valid comment cards but will only be printed if the 
IGNORE=NO parameter is coded. A maximum of two continuation cards can be 
used for comments. 
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IOCP macro instructions are coded in columns | through 71 of each card. You can 
continue a macro instruction that exceeds 71 columns onto one or more additional 
cards by placing a nonblank character in column 72 to indicate the continuation. 
The macro instruction can be interrupted either at column 71 or after any comma 
that separates parameters. The continued portion must begin in column 16 of the 
following card. Comments can appear on continued cards. Columns 73 through 80 
can be used to code identification and/or sequence characters if you choose. IOCP 
prints but does not examine columns 73 through 80. 


Note: If you incorrectly continue a macro instruction and only optional parameters 
appear on the continued portion, IOCP ignores the optional parameters. For 
example, if you do not end the last parameter on a card with a comma and code a 
nonblank character in column 72, IOCP ignores the information on the continuation 
card. To avoid this possible problem, you can code the optional parameters on the 
first card of the macro instruction. Also, check your I/O configuration reports to 
ensure that all channel paths, control units, and I/O devices are defined correctly. 
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Format and Coding Conventions 


The conventions used in this publication to illustrate the format and coding of IOCP 
macro instructions are: 


Uppercase letters, numbers, and punctuation marks must be coded exactly as 
shown. 


Exceptions to this convention are brackets, []; braces, {}; and ellipses, ...; which 
are never coded. 


Lowercase letters represent variables for which you must substitute information 
or specific values. 


Items enclosed in braces, {}, represent alternative items. Only one of the items 
must be coded. 


Items enclosed in brackets, [], are optional. They can be omitted. Conversely, 
the lack of brackets indicates that an item must be coded. 


An ellipsis, ..., indicates that the previous item or group of items can be coded 
two or more times in succession. 


The “or” sign, |, separates alternative items. 


If an alternative item is underlined, it is the default value. [OCP assumes the 
default value is your choice if you do not specify the keyword. 


Single parentheses must enclose single-value subfields, if more than one is coded. 
If only one subfield is specified, you can omit the parentheses. For example. 
you can code either CUNUMBR = (530) or CUNUMBR = 530 on the 
IODEVICE macro instruction. 


Double parentheses must enclose the UNITADD= subfields on the 
CNTLUNIT macro instruction and the PATH= subfields on the CHPID macro 
instruction because these subfields can contain multiple values. (Single 
parentheses enclose each subfield: another set encloses all the subfields.) For 
example, you code PATH =((10,E,1),(11,F)) and PATH =((12,1)). If only a 
single subparameter for one subfield is specified, you can omit the parentheses. 
For example, you can code either UNITADD = ((0A)) or UNITADD = 0A. 


Parameters, subfields, and subparameters coded in the operand field must be 
separated by commas. 


Appendix A. Coding IOCP Macro Instructions A-3 


A-4 


Example: A typical macro instruction might appear as: 

CU1OA CNTLUNIT CUNUMBR=10A,PATH=06,SHARED=N, ss X 
UNIT=2821 ,UNITADD=( (0A, 3) ) Plan 3 

CUIOA is the symbolic name of the macro instruction. 


CNTLUNIT identifies the macro instruction to the system. 


CUNUMBR=10A, PATH = 06, and SHARED=WN are required parameters, 
separated by commas, containing keywords and keyword values. Because the macro 
instruction is continued, a comma follows SHARED=N, and a nonblank character 
(X) ts placed in column 72. 


UNIT = 2821, and UNITADD =((0A,3)) are also required parameters and start in 
column 16 of the continued macro instruction. Because UNITADD =((0A,3)) is the 


last parameter, it is followed by a blank to indicate the end of the operand field. 


Plan 3 is a comment. 
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Figure B-1 shows a listing of a combined input deck containing both LOCP and 
MVS system generation macro instructions. Figure B-2 shows portions of the listing 
produced when IOCP processed the combined input deck shown in Figure B-1. 


Figure B-3 shows a listing of a combined IOCP and MVS Configuration Program 
(MVSCP) input stream. 7 


Figure B-4 shows a listing of IOCP input that contains only IOCP macro 
instructions. Figure B-5 shows a listing of a DMKRIO file used for VM/SP and 
VM/SP HPO system generation. The records in this file correspond to the LOCP 
macro instruction in Figure B-4. Figure B-6 shows a listing of a HCPRIO file used 
for VM/XA Systems Facility system generation. The records in this file correspond 
to the IOCP macro instructions in Figure B-4. 


Note: See “Chapter 5. IOCP Configuration Reports” for examples of the reports 
IOCP produces. 
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———— 


"OS/VS2 COMBINED MVS AND IOCP IG CONFIGURATION DECK? 


TITLE 00019000 
COPY SGGBLPAK 00020000 

ID MSG1="PRACTICE IOCP GENERATION’, x00030000 
MSG2="SAMPLE CONFIGURATION WITH THREE BYTE CHANNELS'* 00040000 

KIOCP 0 --3 nnn 2 == oo ne nn en ne rn en en nn enn en en nee 00050000 
*xIOCP 00060000 
xIOCP DEFINE MVS CHANNELS TO CHPID 00070000 
xIOCP 00080009 
*IOCP CHANNEL SET 0 CHANNEL SET 1 00090000 
xIOCP Cc CC wee Renner nnn ween en nnenn-e CS -é 00100000 
xIOCP H H H oH 00110000 
*IOCP P A AP 00120000 
*I0CP I N NOL 00130000 
xIOCP D DSE 0 DSE 1 D 00140000 
KIOCP mannan a ee 00150000 
xIOCP | 00 | 0 | BYTE 15 | 10 | 00160060 
xIocp { 01 | 6 | BYTE BYTE | 6 | 11 { 060170000 
xrocp | 02 | 1 | 17 [| 12 4 00180000 
xIocP | 03 | 2 | } 8 | 13 | 00190000 
xrocp | 04 {| 3 | 19 [ 14 | 00200000 
xrIocPp | 05 | 4 [ fa] 15] 00210000 
xrocp {| 06 | 5 | { Bf 16 | 00220000 
xIoce [| 07 | 7 | ikea fame a | 00230000 
MIOCP mn ee ee 00240000 
*IOCP 00250000 
xIOCP DSE 2 00260000 
KTOCP wee ne nen nnn none ee o-oo eee 00270000 
XIOCP CHAN 18 | 9 ~A |B T1 $2 3 14 | 00280000 
E00) oe 00290000 
*IOCP CHPID | 20 | 21 | 22 | 23 | 24 | 25 | 26 { 27 | 00300000 
KIOCP eee nn nnn nnn ee ne nn nnn nnn n-e- Baan - ne 00310000 
*IOCP ; 00320000 
xIOCP CHAN CHPIDS 00330000 
*IOCP oe eee eee 00340000 
CHPID PATH=((00,0,0)),TYPE=BY 0 00 00350000 

CHPID PATH=((02,1,0),(24,1,1)),TYPE=BL 1 02 24 00360000 

CHPID PATH=((03,2,0),(25,2,1)), TYPE=BL 2 03 25 00370000 

CHPID PATH=((04,3,0),€26,3,1)),TYPE=BL 3 04 26 00380000 

CHPID PATH=((05,4,0),(27,4,1)),TYPE=BL 4 05 27 00390000 

CHPID PATH=((06,5,0),(10,5,1)),TYPE=BL 5 06 10 00400000 

CHPID PATH=((01,6,0),(€11,6,1)),TYPE=BY 6 Ol 11 00410000 

CHPID PATH=((07,7,0),(12,7,1)),TYPE=BL 7 07 12 00420000 

CHPID PATH=((20,8,0),(13,8,1)),TYPE=BL 8 20 13 00430000 

CHPID PATH=((21,9,0),(014,9,1)),TYPE=BL 9 21 14 00440000 

CHPID PATH=((€22,A,0),(€15,A,1)),TYPE=BL A 22 15 00450000 

CHPID PATH=((23,B,0),(€16,B,1)),TYPE=BL B 23 16 00460000 

CHPID PATH=((17,C,1)),TYPE=BL Cc 17 00470000 

*IOCP DEFINE CHANNELS NOT PRESENT ON THIS 3081 00480001 
*xIOCP 00490001 
CHPID PATH=((%*,D,0)),TYPE=BL D -- 00500003 

CHPID PATH=((%*,E,0)),TYPE=BL E wee 00510003 

CHPID PATH=(¢%*,F,0)),TYPE=BL F -- os 00520003 

*xIOCP 00530000 
xIOCP NOTES: 00540000 
*IOCP 00550000 
x TOCP FORMAT FOR THE CUNUMBR OPERAND IS 00560000 
*xLOCP CUNUMBR=XYZ 00570000 
x I0CP X = CHANNEL SET ID 00580000 
*IOCP Y = CHANNEL NUMBER 00590000 
xIOCP Z = SEQUENTIAL NUMBER FROM 0 TO F 00600000 
x IOCP 00610000 
xIOCP ALL 3830 CONTROL UNITS ARE FEATURED WITH AN ADDRESS 00620000 
xIOCP RANGE OF 16 WHICH IS SPECIFIED ON THE UNITADD OPERAND 00630000 
xIOCP OF THE CNTLUNIT MACRO. 00640000 
xIOCP 00650000 
xI0CP - IOCP SYNTAX CHECKING PERFORMED IN FOREGROUND ON TSO 00660000 
*IOCP ALLOC FCSYSPRINT) DACX) 00670000 
*IOCP ALLOC FCSYSIN) DAC'CONFIG.IOCPGEN.ASMCIOCP)") SHR 00680000 
xIOCP CALL 'TEST.LOADCICPIOCP)! 00690000 
*10CP 00700000 
So Od laren ahaa haeiataiatetatatet tea lalatatahatatadatetaiabetalatatabatatetatelatatetetetetetateteteteetettede 00710000 
xIOCP CHANNEL ZERO ( BYTE ) 00720000 
xIOCP CHANNEL SET ZERO (0) 00730000 
HIOCP 0 wren ne nnn nnn nnn enn ne nn een ne nen en enn nnn en ee ene eee 00740000 
x 00750000 
UR3811#1 CNTLUNIT CUNUMBR=001,PATH=00,PROTOCL=D, SHARED=N, X00760000 
UNIT=3811,UNITADD=02 00770000 

UR3811#2 CUTER CUNUMBR=002,PATH=00,PROTOCL=D,SHARED=N, X00780000 
UNIT=3811,UNITADD=04 00790000 

UR3505#1 CNTLUNIT CUNUMBR=003,PATH=00,PROTOCL=D,SHARED=N, X00800000 
UNIT=3505,UNITADD=((12),(13)) 12 IS 3505,13 IS8.3525 00810000 

TP3705EP CNTLUNIT CUNUMBR=004,PATH=00,PROTOCL=D, SHARED=N> X00820000 
UNIT=3705,UNITADD=((4D,15),(07F,8),(87,5),(A0,16), X00830000 
(B2,62),(FF,1)) 00840000 

IODEVICE ADDRESS=002,CUNUMBR=001,UNIT=3211 00850000 

IODEVICE ADDRESS=004,CUNUMBR=002,UNIT=3211 00860000 

IODEVICE ADDRESS=012,CUNUMBR=003,UNIT=3505 00870000 

IODEVICE ADDRESS=013,CUNUMBR=003,UNIT=3525, FEATURE= TWOLINE 00880000 

IODEVICE UNIT=BSC1,ADDRESS=(04D,15),TCU=2701,ADAPTER=BSCA, X00890000 
CUNUMBR=004 00900000 

IODEVICE UNIT=2741P,ADDRESS=(07F,8),TCU=2702,ADAPTER=IBMIL, X00910000 
SETADDR=1, CUNUMBR=004 00920000 

IODEVICE UNIT=2741P,ADDRESS=(087,5),TCU=2702,ADAPTER=IBM1, X00930000 
SETADDR=1, FEATURE=AUTOANSR» CUNUMBR=004 00940000 

IODEVICE UNIT=BSC3,ADDRESS=(0A0,16),TCU=2703, X00950000 
FEATURE=AUTOPOLL , ADAPTER=BSCA  CUNUNBR=004 00960000 

IODEVICE UNIT=BSC3,ADDRESS=(0B2,62),TCU=2703, X00970000 
FEATURE=AUTOPOLL ,» ADAPTER=BSCA , CUNUMBR=004 00980000 

IODEVICE UNIT=3705,ADDRESS=0FF,ADAPTER=CA1, CUNUMBR=004 00990000 

RIOCP 0 ee nnn enn nnn nnn ne nnn nnn nnn nn ne ene nee nen enn ne nen enn eee 01000000 
xIOCP CHANNEL ONE 01010000 
xIOCP SYMMETRIC DEFINITION OF 2305 DRUMS ACROSS CHANNEL SETS 01020007 
MIOCP 0 wa ern nnn errr nnn nen re ne nn ne enn en nn een en ne en enn enn ene 01030000 
* 01040000 
DR2835#1 CNTLUNIT CUNUMBR=011,PATH=(02,24),PROTOCL=D,SHARED=N, X01050000 
UNIT=2835,UNITADD=((D0,8),(D8,8)) 01060000 

DR2835#2 CNTLUNIT CUNUMBR=012,PATH=(02,24),PROTOCL=D,SHARED=N, xX01070000 
UNIT=2835,UNITADD=((E0,8),(E8,8)) 01080000 

IODEVICE ANDRESS=1D0, CUNUMBR=011,UNIT=2305,MODEL=2 01090000 

IODEVICE ADDRESS=1D8, CUNUMBR=011,UNIT=2305,MODEL=2 01100000 
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IOCP User’s Guide and Reference 


IODEVICE ADDRESS=1E0,CUNUMBR=012,UNIT=2305, MCDEL=2 01110000 
IODEVICE ADDRESS=1E8,CUNUMBR=012,UNIT=2305,MODEL=2 01120000 
KIQCP 0 w2-- === =o 82-2 i t= --------- 01130000 
xIOCP CHANNEL TWO 01140000 
x LOCP . ALL 3830 CONNECTED SYMMETRIC WITH OPTCHAN DEFINING OTHER 01150007 
¥IOCP CPU CHANNEL CONNECTIONS (CHANNELS D, E, F ) 01160007 
xLOCP . DEFINE 3380 DEVICES USING THE DATA STREAMING PROTOCOL 01170007 
RTOCP 0 qn nn nn rn er nner nn rn ne nn ne ne ee eee ee een 01180000 
x 01190000 
DA3830#1 CNTLUNIT CUNUMBR=021,PATH=(03,25),PROTOCL=D,SHARED=N, X01200001 
UNIT=3830,UNITADD=((10,16)) 01210027 
DA3830#2 CNTLUNIT CUNUNBR=022,PATH=(03,25),PROTOCL=D,SHARED=N, X01220001 
UNIT=3830,UNITADD=( (40,16) ) 01230027 
DA3830#3 CNTLUNIT CUNUMBR=023,PATH=(03,25),PROTOCL=D,SHARED=N, X01240001 
UNIT=3830,UNITADD=((§0,16)) 01250027 
DA3880#1 CNTLUNIT CUNUMBR=024,PATH=(03,25),PROTOCL=S,SHAREDEN, X01260001 
UNIT=3880,UNITADD=((80,16)) 01270027 
IODEVICE ADDRESS=(210,8), CUNUMBR=021,UNIT=3330,MODEL=1, X01280000 
OPTCHAN=D, FEATURE=SHARED 01290001 
IODEVICE ADDRESS=(240,4),CUNUMBR=022,UNIT=3350, X01300003 
OPTCHAN=D,FEATURE=SHARED 01310001 
IODEVICE ADDRES$=(260,4),CUNUMBR=023,UNIT=3350, X01320003 
OP TCHAN=E, FEATURE=SHARED 01330001 
IODEVICE ADDRESS=(280,4),CUNUMBR=024,UNIT=3380, X01340000 
OPTCHAN=F, FEATURE=SHARED 01350001 
MIOCP 0 +--+ 2 ---------------- == +++ = 5-2-2 = + +--+ 01360000 
xIOCP CHANNEL THREE 91370000 
*IOCP CHANNEL SET ZERO (0) 01380000 
¥IOCP ; DEFINE DISPLAY AND GRAPHIC DEVICES 01390007 
KIQCP 0 --2-------------+------ 22-8 oo ei re - == - 01400000 | 
x 1410000 
GP3250  CNTLUNIT CUNUMBR=030,PATH=(04),PROTOCL=D, SHARED=YB, X01420001 
i UNIT=3258,UNITADD=((C0,4)) 01430027 
DP3274 = CNTLUNIT CUNUMBR=031,PATH=(04),PROTOCL=D, SHARED=YB, X01440001 
UNIT=3274, UNITADD=( (D0, 16)) 01450027 
IODEVICE CUNUMBR=030,ADDRESS=3C0,UNIT=2250 ,MODEL=3,PCU=1 01460000 
IODEVICE UNIT=3278, ADDRESS=(3D0,2) ,CUNUMBR=031, X01470000 
FEATURE=( EBKY3277,KB78KEY »SELPEN, DOCHAR, X01480000 
AUDALRM) ,MODEL=4 01490000 
IODEVICE UNIT=3278,ADDRESS=(3D2,4) ,CUNUMBR=031, X01500022 
FEATURE=( EBKY3277,KB78KEY , SELPEN, DOCHAR, X01510000 
AUDALRM) , MODEL =3 01520000 
IODEVICE UNIT=3286,ADDRESS=(3D6,2) ,MODEL=2,CUNUMBR=031, X01530000 
FEATURE=DOCHAR 01540000 
IODEVICE UNIT=3277,ADDRESS=( 3D8,8), CUNUMBR=031, X01550000 
FEATURE=( EBKY3277,KB78KEY, SELPEN» DOCHAR; X01560000 
AUDALRM) , MODEL =2 01570000 
MIQCP 0 -----------~--------------- 2+ 7-2-2 =e 01580000 
*IOCP CHANNEL THREE 015 
¥10CP CHANNEL SET ONE (1) 01 
MIOCP 0 wre rrr nr en nn en rr nr rn rn ee ee eee ne 
¥ 
DP3272  CNTLUNIT CUNUMBR=130,PATH=(26),PROTOCL=D,SHARED=YB, x 
UNIT=3272, UNI TADD=((E0,16)) 


NCP3705 CNTLUNIT CUNUMBR=131,PATH=(26),PROTOCL=D,SHARED=N, 
UNIT=3705,UNITADD=FO 
IODEVICE UNIT=3277,ADDRESS=(3E0,4),CUNUMBR=130, 
FEATURE=( EBKY3277,KB78KEY,SELPEN, DOCHAR, 
AUDALRM) ,MODEL=2 
IODEVICE UNIT=3705,CUNUMBR=131,ADDRESS=3F0,ADAPTER=CA2 


xx XK 


PODDDDDDDSCDDDDOCDDCODSCDODDCOCOCOTDOSODOCDOCCOCSCOCOO DCO O COCO OOO OCC OBC OCOD 


KTOCE str erssSsSe5 tesserae Cae ears ee ee Saree ora era eee te eer es 
¥1OCP CHANNEL FOUR 
¥IOCP ALL 3830 CONNECTED SYMMETRIC WITH OPTCHAN USING 4-WAY SWITCHES 
RIQCP. « SPosnsSrSscsssnerssserqsStesse cess seacsse cosa sSesesSss-sqSS2 
x 
DA3830#4 SBTLUNTT CUNUMBR=041,PATH=(05,27,22,15),PROTOCL=D,SHARED=N, x 
NIT=3830,UNITADD=((10, 16)3 
DA3830#5 CNTLUNIT CUNUMBR= 042,PATH= (05, 27,22,15),PROTOCL=D,SHARED=N, x 
UNIT=3830, UNITADD=((40,16)) 
DA3830#6 CNTLUNIT CUNUMBR=043,PATH=(05,27,22,15),PROTOCL=D,SHARED=N, x 
UNIT=3830,UNITADD=((60,16)) 
TODEVICE ADDRESS= =(€410,8), CUNUMBR = 041, UNIT=3330,MODEL=1, x 
A 
eae eit =(440,4),CUNUMBR=042,UNIT=3350, x 
A 
IODEVICE ADDRESS=(460,4),CUNUMBR=043,UNIT=3350, x 
OPTCHAN=A 
RIOCP 0 meee tr rrr rrr rr nn rn rn reer ren rr e nme nner reer meen see nnen 
*I0CP CHANNEL FIVE 
RIQCP 0 eer er rer reer nnn ee cere meen en nnn mene ene nme n nee mame 
x 


x 


TA3803 eNTeUNa CUNUMBR=051,PATH=(06, has PROTOCL=D,SHARED=Y, 
NIT=3803, UNTTADD= €(80,8)) 
TODEVICE ADDRESS=(580,8), CUNUMBR=051,UNIT=3420,MODEL=8, 
FEATURE=(9-TRACK, OPT1600) ,OFFLINE=YES 


x“ 


KIQCP 0 en ne nnn nnn nnn o neon ro nnn en nn nn ne in nnn eee n= e eee 
xIOCP CHANNEL SIX ( BYTE ) 

xIOCP CHANNEL SET ZERO (0) 

¥IOCP . MASS STORAGE CONTROLLER (MSCO AND MSC1) 

xTOCP . UNIT RECORD DEVICES 

ck 1:11 cicetateceatetetatatetateatatateiatetetatenetatatetatatetatatetanatanenmenatatetatanataetaatatantaeeaaemaeenain 


® 
MSC#O CNTLUNIT CUNUMBR=060,PATH=(01,11),UNIT=3851, 
PROTOCL=D,SHARED=N,UNITADD=((10,1)). 
MSCR1 CNTLUNIT CUNUMBR=061,PATH=(01,11), UNIT= 3851, 
PROTOCL=D,SHARED=N, UNITADD= C(C11,1)) 
UR2821 CNTLUNIT CUNUMBR=062,PATH=01,UNIT= 2821, 
PROTOCL=D, SHARED=N, UNI TADD=( (0C,4)) 
IODEVICE UNIT=3851,ADDRESS=(610,1),CUNUMBR=060 
IODEVICE UNIT=3851,ADDRESS=(611,1),CUNUMBR=061 


«x x 


« 
NR REE RE Re rOD DODD ODO OD DDD DDD WOOO OH HW OO WW MW SINS INI NNS A AARADAADAH 


COOSOVHUHDUN HOO ONHUDWNHOVOYRUHBUN POW DYRAUIAHWN HOW MUAUNHUNROWDHNFMSUNE OW 
PCOTHDDTDDODVDVDSOCCOSCDDCVDADDCODDDOCODDCOCOCDODOCDOOSCDC OCC OSCSCOBC OOO S COBO OOOO OOoO 
POVTSOTOTDBDODVDASCDOCODDOTODDDSDCDSCODODTDCOSCSCOSCSO ODOC SCOCOSDOCOCRDOCCOSCOCRKNOAeCOOCeOcDe 
CCOOCTDCOP ROP HORPNENEFOORPMODDOONDDOCOODOCDOTONOGNONGCGCODCOCCOONONGCOCSO 
COCTVTCOCOKPrPORPNNOKPNNNYN ROO FOOD ODO ONDCOCDOSORBCOCOOONONOGNODOVDOSOOSCSCOONGONRrROOOSO 


RVUNRVVVUNNVNUNNNNRANNYNNNE ERE EER ER ER RE PR PEEP RH RRP RE RR Re Re PR eee 


TODEVICE CUNUMBR=062,UNIT=2540R,ADDRESS=60C ,MODEL=1, Xx 
FEATURE=CARDIMAGE 
IODEVICE CUNUMBR=062,UNIT=2540P, ADDRESS=60D, MODEL=1 
TODEVICE CUNUMBR=062,UNIT=1403,ADDRESS=(60E,2),MODEL=N2, © XXX 
FEATURE=UNVCHSET 
MIOCP 0 -on nen nnn none nao noon neo e nn ooo one eno e = 
x10CP CHANNEL SIX ( BYTE ) 
*IOCP CHANNEL SET ONE (1) 
x1OCP 50KB TP LINE FOR NJP WITH A 2701 
MIOCP 0 renner nnn nen nn nn nnn nn nn enn enn nn nnn nnn en enn ne nen e nee 
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Appendix B. Listings of Macro Instruction Input _B-3 


B-4 


¥ 


aanre nn pn a RN 


Figure 


TP2701 


*IOCP 
¥IOCP 
*IOCP 
x10CP 
xITOCP 
x IOCP 


CNTLUNIT CUNUMBR=160,PATH=(11),PROTOCL=D,SHARED=N,UNIT=2701, 
UNITADD=((0A,2)) 
IODEVICE CUNUMBR=160,UNIT=BSC1 ,ADDRESS=(60A,2),TCU=2701, 
ADAPTER=BSCA 
CHANNEL SEVEN 
EXAMPLE OF STRING SWITCH CONTROL UNIT # 070 AND 090 
WITH OPTIONAL AND ALTERNATE PATHS 
SEE CONTROL UNIT AND DEVICE ON CHANNEL 9 


* 
DA3830#7 CNTLUNIT CUNUMBR=070,PATH=(07,14),PROTOCL=D, SHARED=N, 


xIOCP 
¥IOCP 
*IOCP 
xIOCP 
¥IOCP 
xIOCP 


* 
PR3800 
CU3848 


*IOCP 
*IOCP 
¥IOCP 
xIOCP 
*IOCP 
x 


AR3838 


xIOCP 
*TOCP 
¥IOCP 
xIOCP 
¥IOCP 
* 


UNIT=3830,UNITADD=((40,16)) 
CHANNEL EIGHT 
CHANNEL SET ZERO ( 9 ) 
‘ DEFINE 3800 PRINTER 
. CYRPTO UNIT ( 3848 ) DEFINED TO USE DATA STREAMING PROTOCOL 


CNTLUNIT CUNUMBR=081,PATH=(20,13),PROTOCL=D,SHARED=N, 
UNITADD=((€01,1)),UNIT=3800 
CNTLUNIT CUNUMBR=082,PATH=(20),PROTOCL=S,SHARED=N, 
UNIT=3848,UNITADD=((C0,1)) 
IODEVICE CUNUMBR=081,UNIT=3800,ADDRESS=801, FEATURE=CGS2 
IODEVICE CUNUMBR=082,ADDRESS=(8C0), UNIT=3848,MODEL=1 
CHANNEL EIGHT 
CHANNEL SET ONE ( 
DEFINE THE ARRAY PROCESSOR (3838 


CNTLUNIT CUNUMBR=183,PATH=(13),PROTOCL=D,SHARED=N, 
UNITADD=(CE0,8)), UNIT=3838 
IODEVICE CUNUMBR=183,UNIT=3838,ADDRESS=8E0 
CHANNEL NINE 
DEFINE STRING SWITCH DASD ON CONTROL UNIT # 070 , 090 
WITH OPTIONAL AND ALTERNATE PATHS 


DA383088 CNTLUNIT CUNUMBR=6090,PATH=(12,21),PROTOCL=D,SHARED=N, 


UNIT=3830,UNITADD=((40,16)) 


DA3&83089 CNTLUNIT CUNUMBR=091,PATH=(14,21),PROTOCL=D,SHARED=N, 


UNIT=3830,UNITADD=((20,16)) 


STRINGSW IODEVICE ADDRESS=(740,4),CUNUMBR=(070,090),UNIT=3350, 
0 


x 
OPTCHAN 


x 
MSSSTGL 
MSSSTG2 


* 
*IOCP 


* 
¥IOCP 


* 
XIOCP 


*TOCP 
¥IOCP 
¥xIOCP 
*IOCP 
¥* 


cTc 


x IOCP 
*IOCP 
xIOCP 
x ITOCP 
¥IOCP 
x 


xIOCP 
¥IOCP 
¥IOCP 
¥IOCP 
*IOCP 


PTCHAN=9, FEATURE=CALTCTRL) 
IGDEVICE ADDRESS=(920,4),CUNUMBR=091,UNIT=3350 
CHANNEL A 
DEFINE DUMMY UNIT FOR OPTCHAN FROM CHANNEL FOUR (4) 


CNTLUNIT CUNUMBR=0A0,PATH=(22,15),PROTOCL=D, SHARED=N, 
UNIT=DUMMY, UNI TADD=( (00) > 
IODEVICE CUNUMBR=0A0,UNIT=DUMMY, ADDRESS=A00,DEVTYPE=30000001, 
ERRTAB=223 
- CHANNEL B 
TWO. MSS STAGING ADAPTERS (3830-3) WITH A PATK TO EACH 
STAGING ADAPTER AND THE IODEVICES STRING SWITCHED 


CNTLUNIT CUNUMBR=0B0,PATH=(23),PROTOCL=D,SHARED=N, 
UNIT=3830,UNITADD=((80,64)) 

CNTLUNIT CUNUMBR=0B1,PATH=(16),PROTOCL=D,SHARED=N, 
UNIT=3830,UNITADD=( (80,64) ) 


DEFINE THE MSS TABLE PACKS 
IODEVICE CUNUMBR=(0B0,0B1),UNIT=3330,ADDRESS=(B80,2),MODEL=11 
FEATURE=(ALTCTRL, SHARED) 
IODEVICE CUNUMBR=(0B0,0B1),UNIT=3330,ADDRESS=(B&8,2),MODEL=11, 
FEATURE= CALTCTRL, SHARED) 


DEFINE THE MSS CONVERTIBLE PACKS 
IODEVICE CUNUMBR=(0B0,0B1),UNIT=3330,ADDRESS=(B83,2),MODEL=11 
FEATURE=(ALTCTRL, SHARED) 
IODEVICE CUNUMBR=(0B0,0B1),UNIT=3330,ADDRESS=(B8A,2) ,MODEL=11 
FEATURE=CALTCTRL, SHARED) 


DEFINE THE MSS STAGING VOLUMES 
IODEVICE CUNUMBR=(0B0,0B1),UNIT=3330V,ADDRESS=(B82,1), 
FEATURE=(ALTCTRL, SHARED) 
IODEVICE CUNUMBR=(0B0,0B1), eo 3330V,ADDRESS=(B85,3), 
FEATURE= (ALTCTRL, SHARED 
IODEVICE CUNUMBR=<OB650B1), UNIT=3330V, ADDRESS=(B8C,52), 
FEATURE=C(ALTCTRL, SHARED) 
CHANNEL C 
DEFINE CHANNEL-TO-CHANNEL ADAPTER (CTC) 


CNTLUNIT CUNUMBR=0C0,PATH=17,PROTOCL=D, SHARED=N, 
UNIT=CTC,UNITADD=CO 
IODEVICE ADDRESS=CCO,CUNUMBR=0C0,UNIT=CTC, FEATURE=370, 
TIMEOUT=N 
CHANNEL D 
THIS CHANNEL IS NOT CONNECTED TO THIS 3081 
DEVICES ARE OPTCHAN'D FROM CHANNEL 2 


IODEVICE CUNUMBR=%**, UNIT=DUMMY, ADDRESS=D00,DEVTYPE=30000001, 
ERRTAB=223 
CHANNEL E 
THIS CHANNEL AND DEVICES ARE NOT PeaNEcTeD TO THIS 3081 
DEVICES ARE OPTCHAN'D FROM CHANNEL 


02210000 
X02220000 
02230000 
X02240000 
02250000 
02260000 
02270000 
62280007 
02290019 
02300000 
02310000 
02320000 
X02330000 
02340027 
02350000 
02360000 
02370006 
02380006 


0240 


024 


1 
2 
3 
4 
5 
0246 
7 
8 
9 
0 
0251 

2 


POSBDODSSPDDDDDAONONTCOSHODSONGVDDDDOSCOOONSONOSGO 
OVODDSSPONDODDOYVONDDOWDDTDDDQDIYDVDRAKRHDARHRONHNSCAS 


02810013 
02820018 
02830000 
02840000 
X02850026 
02860012 
X02870016 
02880020 
02890018 
02900022 
»X02910022 
02920024 
X02930022 
029460025 
02950018 
02960022 
»X02970022 
02980025 
»X02990022 
03000025 
03010018 
03020022 
XX03030018 
03040025 
XX03050018 
03060025 
XX03070018 
03080025 
03090000 
03100000 


031 
032 


032 
x032 
032 


oo 
WUw 
Nn 


N 
SwWONDUFUNMH OW 
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IOCP User’s Guide and Reference 


¥ 03310001 
IODEVICE ADDRESS=(E10,8),CUNUMBR=%**, UNIT=3330,MODEL=1 03320001 

IODEVICE ADDRESS=(E40,4) ,CUNUMBR=*x*, UNIT=3350, X03330001 
OPTCHAN=F 03340001 

NTOCP: . SShesseote nets sarnsS restr se Serre SaaS er CRASS Se Sree SSS 03350001 
¥IOCP CHANNEL F 03360001 
*IOCP . THIS CHANNEL AND DEVICES ARE NOT CONNECTED TO THIS 3081 03370007 
*IOCP . DEVICES ARE OPTCHAN'D FROM CHANNEL 2 03380007 
MIOCP 0 meer rer rr re rrr rr rrr rn rer nr ren rence cre rc r sess 03390001 
X 03400001 
TODEVICE CUNUMBR=X*,UNIT=DUMMY, ADDRESS=F00,DEVTYPE=30000001, X03410001 
ERRTAB=223 03420001 

IODEVICE ADDRESS=(F10,8),CUNUMBR=***, UNIT=3330,MODEL=1 03430001 

IODEVICE ADDRESS=(F60,4),CUNUMBR=***,UNIT=3350 03440001 

EJECT 03450001 

3 HIE E33 HIE DEE DDE EID 3 OO IE OIE OI OO OI HH HHH IH HH 03460000 
* * 03470000 
x UNITNAME * 03480000 
* * 03490000 
YE HEE EEE HIE OK OI HE DE D0 3 9 DD EE 3 0 3 I EHH IEHHH He 03500000 
UNITNAME NAME=SYSRDR-UNIT=(012,60D) 03510000 

UNITNAME NAME=SYSCP,UNIT=(013,60E) 03520000 

SPACE 3 03530000 

UNITNAME NAME=SYSDA,VIO=YES, X03540000 
UNIT=((210,8),0240,4),(260,4),0280,4), X03550000 
(410,8),0440,4),(460,4)) 03560000 

UNITNAME NAME=SYSDA,VIO=YES, X03570000 

UNE T=(6740,4).0920,4)) 03580006 

UNITNAME NAME=SYSSQ,VIO=YES, X03590000 
UNIT=(€(210,8),0240,4),(260,4),0280,4), X03600000 
€410,8),0440,4),(460,4)) 03610000 

UNITNAME NAME=SYSSQ,VIO=YES, X03620000 
UNIT=((740,4),0920,4)) 03630006 

SPACE 3 03640000 

UNITNAME NAME=DASD,VIO=NO, X03650000 
UNIT=((210,8),6240,4),(260,4),0280,4), X03660000 
€410,8),0440,4),(0460,4)) 03670000 

UNITNAME NAME=DASD,VIO=NO, X03680000 
UNIT=((740,4),0920,4)) 03690006 

SPACE 3 03700000 

UNITNAME NAME=TAPE, X03710000 
UNIT=((580,8)) 03720000 

SPACE 3 03730000 

V3330 UNITNAME NAME=V3330,VIO=YES,UNIT=((740,4)) 03740006 
EJECT 03750000 

PETTITT Tritt ittititttitttittiitti ti tis titi test tise eet e eet e tees. ae hee LED 
x KR * * 03770000 
x * HX CONSOLES x * * 03780000 
x eX * * 03790000 
YE HEE HE DE IH DED EE IE HEHE IK 3 CHE ID IE 3 EE OE DE 3 HEI 3 HE 3 3 IE IE HE IH HE HHH HHH HKHHH KH 03800000 
CONS CONSOLE MCONS=3D0,ALTCONS=3E0,ROUTCDE=ALL,PFK=12,AREA=14 03810000 
CONSOLE SECONS=3DL,ALTCONS=3E1,ROUTCDE=ALL,PFK=12, X03820000 
VALDCMD=(1,2,3), AREA=14 03830000 

CONSOLE SECONS=3D2,ALTCONS=3D3,ROUTCDE=ALL ,PFK=24, X03840000 
VALDCMD=(1,2,3),AREA=14 03850000 

CONSOLE SECONS=3D3,ALTCONS=3D4,ROUTCDE=ALL, PFK=24, X03860060 
VALDCMD=(1,2,3),AREA=14 03870000 

CONSOLE SECONS=3D4,ALTCONS=3D5,ROUTCDE=ALL,PFK=24, X03880000 

: VALDCMD=(1,2,3),AREA=14 03890000 

CONSOLE SECONS=3D5,ALTCONS=3D2,ROUTCDE=ALL ,PFK=24, X03900000 
VALDCMD=(1,2,3),AREA=14 063910000 

CONSOLE SECONS=0-3D6,ALTCONS=0-3D7,ROUTCDE=ALL 03920000 

CONSOLE SECONS=0-3D7,ALTCONS=0-3D6,ROUTCDE=ALL 03930000 

CONSOLE SECONS=3D8,ALTCONS=3D9, VALDCMD=(1,2,3), X03940000 
PFK=12,ROUTCDE=(1,2,3,4,8,10),AREA=14 03950000 

CONSOLE SECONS=3D3,ALTCONS=3D8,VALDCMD=(1,2,3), X03960000 
PFK=12,ROUTCDE=(1,2,3,4,8510),AREA=14 03970000 

CONSOLE SECONS=3E0,ALTCONS=3E1;,ROUTCDE=ALL,PFK=12, X03980000 
VALDCMD=(1,2,3),AREA=14 03990000 

CONSOLE SECONS=3E1,ALTCONS=3D3,ROUTCDE=ALL,PFK=12, X04000000 
VALDCMD=(1,2,3),AREA=14 04010000 

CONSOLE SECONS=3E2, AL TCONS=3D4,ROUTCDE=ALL,PFK=12, X04020000 
VALDCMD=(1,2,3),AREA=14 04030000 

CONSOLE TYPE=JES,VALDCMD=3 04040000 

T 04050000 

X WOR O00 DORI H HIGH 39-0406 0.0.00 
eX x * * 04070000 
eH XH CONTROL PROGRAM x * * % 04080000 
x * X x * * 04090000 
3 YEE HE 3 9 9 BEE EC 3 3 3 93 9 0 9 9 I DH HOHE H—-04:100000 
CTRL CTRLPROG OPTIONS=CDEVSTAT,RDE,RER,BLDL,CRH),SQA=8,CSA=1000, X04110000 
VRREGN=128,TZ=(W,5),ASCII=INCLUDE, REAL=512,WARN=0, 04120000 

EJECT 04130000 

3 EEE CH IE J DEE DEK 3 90 9 0 OE 3 93 3 9 9 EO 8 DEE DE HE EMH 04140000 
x * X * * *® 04150000 
eH KX SCHEDULER * * * * 04160000 
x * ¥ : x ® * 04170000 
HHI IEE IIE HEHE IE BE HE 33 HEHE IE 3 HE HE 9 HE HE HE HE HC BEI IE OE EK 3 HE DEE EI EE OEE IE EEK HHH X 04180000 
SCH SCHEDULR BCLMT=50, ** TSO SCHEDULER REQUEST xx X04190000 
HARDCPY=(SYSLOG,ALL,CMDS), X04200900 
SUBSYS=(JES4,JES5) 04210000 

EJECT 04220000 

X00 00000200000 OOO UGE OOOO UHHH 9604230000 
¥ eX x *® * 04240000 
xR KX CHECK POINT * * * * 04250000 
x KK x * ® 04260000 
JE OI 336 26 30 96 906 333 0 3 3 6 OE I I 3 3 9 HE OE IO HEHEHE 04270000 
CHKPT CKPTREST ELIGBLE=(20,100,101,102,103,110,120,140,160,4092) 04280000 
EJECT 04290000 

YEH IEEE I IIE IE EE HE IK IE 3 HC 3 CE I IEE CE OE IE 9 3 DE HE 3D HE 3K DE IE HE HEE HHI HH 04300000 
x * * ® * 04310000 
HK KK DATA MANAGEMENT x * * *¥ 04320000 
x * xX * * * 04330000 
SEH IEE IEEE IE III HE I DIC IC HK HE HE 3K 33 EI IE 9 IED 3 DH HEI I HE EO IE OI EHH X 049340000 
DATAMAN DATAMGT ACSMETH=(BTAM, TCAM,ISAM,GAM,VTAM), X04350000 
GRAPHCS=(PORRTNS, GSP), IND=YES,UCSDFLT=ALL 04360000 

EJECT 04370000 
300000300006 3 EE 93 99 9 9 9 EE EE I OEM > 043580000 
x KX x ® *® 04390000 
xX KR Tso x *¥ * * 04400000 
x * x x * * 04410000 
% 3000000020000 0030 0 EEE HK HHH 04420000 
TSO TS0 LOGTIME=600 04430009 
EDIT EDIT DSTYPE=CIPLI), BLOCK=(1680,3120),FORMAT=FIXED, XX04440000 
. FIXED=(80-80),PRMPTR=CIPLI) 04450000 
EJECT : 04460000 
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Figure B-1 (Part 4 of 5). A Combined Input Deck (IOCP and MVS System Generation) 


Appendix B. Listings of Macro Instruction Input 


B-5 


SVC-224-T4-FC00, X0483 
$VC~-223-T3-FC00, X0484 
$VC-222-T3-FCO0, X0485 
SVC-221~-T3-FC00, X0486 
$VC-220-T1-FCO0, ji X0487 
$VC-219-T3-FCO00, X0488 
$VC-218-T3-FCO0, X048 
S$VC-217-T3-FC00, X049 
S$VC~216-T3-FCO0, 
$VC-215-T3-FCO06, 
$VC-214-T3~-FC00, 
$VC-213-T3-FCO0, 
$VC-212-T2-FCO0, IMS TYPE 2 SVC X04 
$VC-211-T2~FC00, 
SVC-210-T2-FCO0, 
S$VC-209-T3-FCOS, X049 
SVC-208-T3-FCOO, . X049 
S$VC-207-T3-FC00, x050 
SVC-206-T3-FC00, X050 


« «KKK 
ooo°o 
PODLH 
w5owwsv 


>< 
20 
Ce 
wu 


[ * DE HE 3K 9 IE HEE HK IE HE DE IE DE HEE BE BE IE HE DE HEE I HE HEE 3 DE BE IE HE HCE 3 DK IE IEE HCE HE I IE EH HE I HE HK KE * 04470000 
mx x ; x * * 04480000 
| HOR SVC TABLE xX ¥ ¥ 04490000 
RK Xx x * * 04500000 
* 3 HE HE HE HE HE HE HH HEH HE 3 HE HEHEHE I 3 3 3 DE HE OK HO HO EH HE KH HE HE HE IE HE OK EO HE OK HE I OHO * 04510000 
SVCTAB . SVCTABLE $VC-255-T1-FCO00, X04520000 
SVC-254-T4-FC00, X04530000 
SVC-253-T4-FC00, X04540000 
$VC-252-13-FC00, X04550000 
$VC~251-T3-FC00, X04560000 
$VC-250-T4-FC00, X04570000 
SVC-249-T4-FC00, X045800 
SVC-248-14-FC00, X04590 
$VC-247-T4-FC00, X04600 
SVC-246-T4-FC00, X04610 
SVC-245-T4-FC00, X04620 
SVC~244-T1-FC00, X04630 
_-$VC=243-T1-FCO0, X04640 
SVC-242-T4-FC00, X04650 
; SVC-241-T4-FC00, X0466 
SVC-240-T4-FC00, X0467 
| /  $VC+239-T4-FC00, X0468 
| $VC-238-T4-FC00, X0469 
SVC-237-T4-FC00, X0470 
SVC-236-T4-FC00, X0472 
SVC-235-T4-FC00, X0472 
SVC-234-T4-FC00, X0473 
SVC~233-T4-FC00, X0474 
SVC-232~T4-FC00, X0475 
SVC~231-T4-FC00, X0476 
$VC-230-T4-FC00, X0477 
$VC-229-T4-FC00, X0478 
$VC-228-14-FCO0, X0479 
SVC-227-T4-FC00, X0480 
SVC-226-T4-FC00, X0481 
. - §VC-225-T4-FC00, io X0482 


WONTAR UNM EH OD ONIDUARWNHODON AD RUN ROW 
POTDDDHOOCDGHOCSCOODCOODDDDDDOOOCDODODOCDDOGDORD OOOO OOCOOCOOOOCOD OOO SCOOOCOODBDOOO 


SCOCCOCODOSCDSOSCSDSDDODSSSOSCDOSCRAODOOSOOO COO RQDDOD COSC COOODCDOOSCODOORZ GOOD OCOORBSTOCGOSDCOCOCODOSDC OOOO OOOCOOOCOORS 


S$VC-205-T3-FC00, . x050 
SVC-204-T3-FC00, x050 
SVC-203-T1-FCO0, ‘ X050 
$VC-202-T3-FCO0, X050 
SVC-201-T3-FCO0, , X050 
S$VC-200-T3-FCO00, X050 
SVC-199-T1-FCO00, IMS-VS 1.1.1 OS-VS2 REL4 SVCS xX050 
SVC-198-T1-FCOO, IMS-VS 1.1.1 OS-VS2 REL4 SVCS X050 
$VC-197-T2-FCO0, IMS-VS 1.1.1 OS-VS2 REL4 SVCS X051 
SVC~196-T2-FCO0, IMS-VS 1.1.1 OS-VS2 REL4 SVCS X052 
SVC-195-T4-FC00,  IMS-VS 1.1.1 OS-VS2 REL4 SVCS X051 
Spee SVC-194-T4-FC00. IMS-VS 1.1.1 OS-VS2 REL4 SVCS Hee 
; 0 
3 HCE 30 30 2 96 36 DE DE 30 2 IE I HE DE 3 DE DE HEE 3 IE 3 HE 3 EE EHEC KE HE DIE I OK EE OE OE 9H OE IIE 051 
HX . x * * 051 
eR aa DATA SETS * * * ® 051 
* * # * x * 051 
333636 96 96 9 30 9 0 9 3 CE 98 3 EE BE DE 3 9 98 98 DE 3K 3 9 3 3 3 9 3 3 98 OE 3 3 9 3 3 OE DE 3 OE 3 3 EO DE OO EIEN 5D 
DATASET IMAGELIB, VOL=(DRV308,3330) 0520 
DATASET JES3LIB,VOL=(DRV308,3330) 0521 
DATASET LINKLIB,VOL=(DRV308,3330) 0522 
DATASET MACLIB,VOL=(DRV308,3330) 0523 
DATASET MANX, VOL=(DRV308,3330) 0524 
DATASET MANY, VOL=(DRV308,3330) 0525 
DATASET NUCLEUS, VOL=(DRV308,3330) 0526 
DATASET PROCLIB,VOL=(DRV303,3330) 0527 
DATASET SVCLIB,VOL=(DRV308,3330) 0528 
DATASET TELCMLIB, VOL=(DRV308,3330) 0529 
DATASET UADS,VOL=(DRV308,3330) 0530 
DATASET SAMPLIB,VOL=(DRV308,3330) 0531 
DATASET BRODCAST,VOL=(DRV308,3330) 0532 
DATASET CMDLIB, VOL=(DRV308,3330) 0533 
DATASET DCMLIB, VOL=(DRV308,3330) 05340 
DATASET HELP, VOL=(DRV308,3330) 05350 
DATASET PARMLIB,VOL=(DRV308,3330) 05360 
DATASET LPALIB,VOL=(DRV308,3330) 05370 
DATASET VTAMLIB,VOL=(DRV308,3330) 05380 
DATASET VSCATLG,VOL=(PAGE08,3330),NAME=PAGE08. CATALOG 05390 
DATASET PAGEDSN=SYS1 .PG33301 05400 
DATASET PAGEDSN=SYS1.PG633302 : 05410 
DATASET PAGEDSN=SYS1.PG33303 05420 
DATASET STGINDEX, VOL=(PAGE08, 3330) ; 05430 
EJECT ; 05440 
JE OE FEE DERE IE 3 0 3K 96 3 3 HED 3 9 3K 3 OE 3 EE 3 HE DE 3 9 3 9 3 9 08 3 IE I EE 3 ED EO HE 5 9 IE 3 OE IO EK IKK 05450 
x * * x * ¥ 05460 
* XH AFFINITY x *% ¥ * 05470 
* * * * * * 05480 
FE HEHEHE HE HE HE 99K IE HE 9 EE 9 OE DEE 3 DE 9 3 3 DE OK IC EE BO DE EE OE 9 DE IE OE EE ED HE EOE OE EEK HHH 3H 05490 
AFFINITY AFF-AFFPGM01-1,AFF-AFFPGM02-0,AFF-AFFPGM03-1, X05500 
AFF-AFFPGM04-0,AFF-AFFPGM05-1, X05510000 
| AFF-AFFPGMO6-0,AFF-AFFPGMO7~-1 05520000 
EJECT 05530000 
334 96 38 3 3K 3 HE 3 HE 9 3 3 3 3 3K 3 EO 3 9 3 ED 3 EE 3 DE 3K 3 9K DE 3 9 3 98 3 HE 3 OK 3 IE 3 HE OE 3 IE DE OE OK DEO EHH HIM % 05540000 
x # . : * * * 05550009 
x HK OR : GENERATE * * * * 05560000 
x * * : : * * * 05570000 
36938630333 3 3 3 36 3 3 9 3 90 EE 3 9 3 9 3 3 2 3 9 8 9 9 9 9089 99K 9 05580000 
GENERATE GENTYPE=(10,1), X05590013 
OBJPDS=SYS1.SSSPDS, X05600000 
RESVOL=(DRVJHM, 3330), , X05610000 
INDEX=SSS1,; X05620000 
JCLASS=N, X05630000 
OCLASS=M 65640000 
33633 EEE DEE DE BE DE 3 0 9 3 8 3K 9 98 3 C9 I IE DE 3 3 3 3 DE IE 3 IE DE 3 OC 3 3 E33 DE BEE EO OEE IKI 3H 05650015 
x * * * 05660015 
eH HOR INCLUDE MACRO FOR 3848 CRYPTO SUPPORT x * *® * 05670021 
KR ® . x *¥ * 05680015 
3 99 33 33 HE DE 3K 3 HE DE BE 3K 3 OE BE 3 3 3 HEH 9 3K 3 9 9 3 ED 3 3 HE HE OK I HE 3 IE HO EE HE KKH HHIKHHK 3H 05690015 
Icucusep 05700000 
END 05710000 
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LISTING OF ee ile PROCESSED BY IOCP AND ERRORS DETECTED -- IGNORE=YES 


D MSGIL='PR/CTICE IOCP GENERATION’, X00039000 
MSG2='SAMPLE CONFIGURATION DIITH THREE BYTE CHANNELS 0c040c00 
RIOCR  VGrin RDS CMSS Tel Tata race ae eee ee eee ee 00050060 
¥10CF 00060000 - 
*IOCP DEFINE MVS CHANNELS TO CHPID 00070600 
xTOCP 60080000 
x LOCP CHANNEL SET 0 CHANNEL SET 1 00099000 
®TOCP Cc Co OPE gir sssnese | cl, CR MacSrseSsses CoS 00100000 
xIGCP H H H oH 00110000 
*TOCP P A AP 00120000 
*IOCP I N Ny 60136000 
xICCP D DSE 0 DSE 1 D 60140000 
BIQCR: “SE RTE Sere oe tm 00150000 
xIOCP {| 00 | O | BYTE 15 | 10 | 00160000 
xIOCP | 01 { 6 | BYTE BYTE | 6 | 11 | 00170000 
xIocp | 02 | 1 | 17 1] 12 4 00180000 
xrocp | 03 | 2 | {8 | 13 | 90190000 
xlocp | 04 | 3 | 19 | 14 { 00200000 
xrocp | 05 | 4 | [al 15 | 0210000 
XIOCP | 06 | 5 | {Bf 16 | 00220000 
*1OCcP | 07 | 7 | West es ae fy | 00230000 
¥TOCP mee ne es a 00240000 
*xTOCP 00250000 
xTOCP DSE 2 00260000 
¥TOCR. +...) Sabo scseuse sete eos eet eels tedace 00270000 
xIOCP CHAN | 8 [9 {A £B {i 12 43 14 = 00280000 
MELOCP 0 byl Bea S ses sacede nS satis S eso See eases 00290000 
xIOCP CHPID { 20 { 21 | 22 | 23 | 24 | 25 | 26 | 27 | 00300000 
MIOCR 0 7) ABerSaepoetiraicice Semseescres sass cetene 060310000 
xIOCP 00320000 
xIOCP CHAN CHPIDS 06330000 
xLOCP tie | eee 00340000 
CHPID PATH=((00,0,0)),TYPE=BY 0 00 00359000 
CHPID PATH#((02,1,0),(24,1,1)),>TYPE=BL 1 02 24 00360000 
CHPID PATH=((03,2,0),(25,2,1)),TYPE=BL 2 03 «25 90370000 
CHPID PATH=((04,3,0),(26,3,1)),TYPE=BL 3 04 «26 00380000 
CHPID PATH=((05,4,0),(27,4,1)),TYPE=BL 4 05 27 60390000 
CHPID PATH=((06,5,0),(19,5,1)),TYPE=BL 5 06 10 00400000 
CHPID PATH=((01,6,0),(€11,6,1)),>TYPE=BY 6 Ol 11 00410000 
CHPID PATH=((07,7,0),(12,7,1)),TYPE=BL 7 07° «12 00420060 
CHPID PATH=((20,8,0),(13,8,1)),TYPE=BL 8 20 13 00430000 
CHPID PATH=((21,9,0),¢14,9,1)),TYPE=BL 9 21 14 00440000 
CHPID PATH=((22,A,0),(15,A,1)),TYPE=BL A 22 15 00450000 
CHPID PATH=((23,B,0),(16,B,1)),TYPE=BL B 23 16 00460000 
CHPID PATH=((17,C,1)),TYPE=BL c 1 00470000 
¥TOCP DEFINE CHANNELS NOT PRESENT ON THIS 3081 00480001 
¥IOCP ; 00490001 
CHPID PATH=((*%,D,0)),TYPE=BL D -- =e 00500003 
ICPL11I ¥*WARNINGXX PATH INFORMATION DEFINED WITH %* IS EXCLUDED FROM IOCDS 
CHPID PATH=((%*,E,0)),TYPE=BL E -- = 00510003 
ICPL11I XXWARNINGXX PATH INFORMATION DEFINED WITH %* IS EXCLUDED FROM IOCDS 
CHPID PATH=C(%*,F,0)),TYPE=BL F -- oe 00520003 
ICPLILI %xXWARNING®® PATH INFORMATION DEFINED WITH %* IS EXCLUDED FROM IOCDS 
*xIOCP 00530000 
xIOCP NOTES: 00540000 
*xIOCP 00550000 
xIOCP . FORMAT FOR THE CUNUMBR OPERAND IS 00560000 
*IOCP CUNUMBREXYZ 00570000 
*xIOCP X = CHANNEL SET ID 00580000 
*xITOCP Y = CHANNEL NUMBER 00590000 
*xILOCP Z = SEQUENTIAL NUMBER FROM 9 TO F 00600000 
XxIOCP 00610000 
xTOCP . ALL 3830 CONTROL UNITS ARE FEATURED WITH AN ADDRESS 00620000 
xIOCP RANGE OF 16 WHICH IS SPECIFIED ON THE UNITADD OPERAND 00630000 
xIOCP OF THE CNTLUNIT MACRO. 00640000 
*IOCP : 00650000 
xIOCP . IOCP SYNTAX CHECKING PERFORMED IN FOREGROUND ON TSO 00660000 
xIOCP ; ALLOC FCSYSPRINT) DAC) 00670000 
*IOCP ALLOC FCSYSIN) DAC'CONFIG.IOCPGEN.ASMCIOCP)') SHR 00680000 
xIOCP CALL ‘TEST. LOADCICPIOCP)! 00690000 
*xIOCP 00700000 
KTOCP 0 renee ne nnn nnn nn nnn nn rn nn nnn nner nner cen enann 00710000 
XIOCP CHANNEL ZERO ¢ BYTE ) 00720000 
¥TOCP CHANNEL SET ZERO (0) 00730000 
KIOCP 0 ee ene nnn nnn nnn rene ne nn nnn rn nn ne enn nnn nnn rrr ene nner sane 00740000 
UR3811#1 CNTLUNIT CUNUMBR=001,PATH=00,PROTOCL=D,SHARED=N, X00760000 
UNIT=3811,UNITADD=02 00770000 
UR38114#2 CNTLUNIT CUNUMBR=002,PATH=00,PROTOCL=D,SHARED=N, X00780000 
UNIT=3811,UNITADD=04 00790000 
UR350541 Sire CUNUMBR=003,PATH=00,PROTOCL=D,SHARED=N, X00800000 
NIT=3505,UNITADD=((12),(13))' 12 IS 3505,13 IS 3525, rer 
TP3705EP CNTLUNTE CUNUMBR=004,PATH=00,PROTOCL=D,SHARED=N, 820000 
UNIT=3705,UNITADD=((4D, 15) ,(7F 83, (87,5) ,(A0,16)> xo08s0000 
(B2,62),(FF,1)) 00840000 
IODEVICE ADDRESS=002, CUNUMBR=001,UNIT=3211 00850000 
ITODEVICE ADDRESS=004, CUNUMBR=002,UNIT=3211 00860000 
IODEVICE ADDRESS=012, CUNUMBR=003,UNIT=3505 00870000 
IODEVICE ADDRESS=013,CUNUMBR=003,UNIT=3525, FEATURE=TWOLINE 00880000 
IODEVICE UNIT=BSC1,ADDRES$S=(04D,15),TCUS2701,ADAPTER=BSCA,  X00890000 
CUNUMBR=004 609000¢0 
IODEVIGE UNIT=2741P, ADDRESS=(07F,8) , TCU=2702, ADAPTER= IBM1,  X00910000 
SETADDR=1,CUNUMBR=004 00926000 
IODEVICE UNIT=274iP, ADDRESS=(087,5),TCUS2702,ADAPTER=IBM1, X00930000 
| SETADDR=1, FEATURE=AUTOANSR, CUNUMSR=004 00940000 
IODEVICE UNIT=BSC3,ADDRESS=(0A0,16), TCU=2703, X06950000 
FEATURE=AUTOPOLL , ADAPTER =BSCA, CUNUMBR=004 00960000 
IODEVICE UNIT=BSC3,ADDRESS=(CB2,62), TCU=2703, X00970090 
FEATURE=AUTOPOLL, ADAPTER=BSCA, CUNUMBR=004 09980090 
IODEVICE UNIT=3765,ADDRESS=OFF,ADAPTER=CA1, CUNUMBR=004 00599000 
MIOCP 0 meee enn nn een se nn arn enn en nn er resem nn nnn en eeres o1s0cono 
XICCP CHANHEL ONE olo1ocec 
*xIGCP SYMMETRIC DEFINITION OF 2505 DRUMS ACROSS CHANNEL SETS 01020007 
RIOCP (0 wre nn ene eee nn ne nen rn en te rr re een renee nnn n cr eccen closeees 
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IODEVICE ADDRESS=(920,4),CUNUMBR=091,UNIT=3350 02690000 

RLOChs - see Sot eee See See See eRe ees Ga eS Sees eS She See 02700000 
¥1OCP CHANNEL A 62710000 
¥IOCP . DEFINE DUMMY UNIT FOR OPTCHAN FROM CHANNEL FOUR (4) 02720007 
SLUCE (See SSS e Se eee ee CS ee ee ee See Mee Hee Rare eM ee SiS ek 02730000 
OPTCHAN aa! CURUMBR=040,PATH=(22,15), EROLOCES De SHARED=Ns X02750000 
NIT=DUMNI1Y, UNITADD=((06)) 02760000 

IODEVICE CUNUMBR=0A0,UNIT=DUSINY, ADDRESS=A00, /DEVTYPE= 30000001, X02770000 
ERRTAB=223 02730000 

xIOCP PUSS S Por PRA S ae eo wa ee Ae PE RE Ser rere ae a ee 02750000 
x1OCP CHANNEL B 02803000 
xIOCP . TWO MSS STAGING ADAPTERS (3830-3) WITH A PATH TO EACH 02810018 
xIOCP STAGING ADAPTER AND THE IODEVICES STRING SWITCHED 02820018 
SIUCE, . SSaeiw oe bree See So ie Hee Kes eeS eee Mew eee Snes Sao hee 02830000 
MSSSTG1 CHNTLUNIT CUNUMBR=0B0,PATH=(23),PROTOCL=D,SHARED=N, X02850026 
NIT=3830 ,UNITADD=((80,64)) 62860012 

MSSSTG2 CNTLUNIT CUNUNBR= OBL, PATH=(16),PROTOCL=D, SHARED=N,  X02870016 
UNIT=3830, UNITADD= €(€80,64)) 02886020 

¥IOCP DEFINE THE NSS TABLE PACKS 02900022 
IODEVICE CUNUMBR=(0B9,0B1),UNIT=3330,ADDRESS=(B8C0,2),MODEL=11,X02910022 
FEATURE=CALTCTRL, SHARED) 02920024 

IODEVICE CUNUMBR=(080,0B1) ,UNIT=3330,ADDRESS=(B88,2),MODEL=11,X02930022 
FEATURE=(CALTCTRL, SHARED) 02940025 

xIOCP DEFINE THE MSS CONVERTIBLE PACKS 029690022 
TODEVICE CUNUMBR=(0B0,081),UNIT=3330,ADDRESS=(B83,2),MODEL=11,X02970022 
FEATURE=C(CALTCTRL, SHARED) 02980025 

IODEVICE CUNUMBR=(0B0,021),UNIT=3330,ADDRESS=(B8A,2),MODEL=11,X92990022 
FEATURE=CALTCTRL, SHARED) 03900025 

xIOCP DEFINE THE NSS STAGING VOLUMES 03020022 
IODEVICE CUNUMBR=(0B0,0B1),UNIT=3330V,ADDRESS=(B82,1), XX03030018 
FEATURE=(ALTCTRL, SHARED) 03040025 

IODEVICE CUNUMBR=(0B0,0B1),UNIT=3330V,ADDRESS=(B85,3), XX03050018 
FEATURE=CALTCTRL, SHARED) 03060025 

TODEVICE CUNUMBR=(0B0, 0B1), UNIT=3330V,ADDRESS=(B8C,52), XX03070018 
FEATURE=(ALTCT&L, SHARED) 03080025 

MIOCPs © (SS SerSScasene Sener Sates et Srser nee Seer Ss es reer sess Sees se 03090090 
¥ITOCP CHANNEL C 03100000 
xITOCP . DEFINE CHANNEL~TO-CHANNEL ADAPTER (CTC) 03110007 
NIOCR) sees ess=cce sneered cts one Seo rr ee nS er een ee ee See e Ses 63120000 
crc CNTLUNIT CUNUMBR=0C0,PATH=17,PROTOCL=D, SHARED=N, X03140000 
UNIT=CTC,UNITADD=C0 63150000 

IODEVICE ADDRESS=CC0,CUNUMBR=0C0,UNIT=CTC,FEATURE=370, X03160000 
TIMEGQUT=N 03170000 

STOCP. (ress essee ass escrito reer s aS sr Tess Sar sees S seer see sess 03180001 
*IOCP CHANNEL D 03190001 
x IOCP : THIS CHANNEL IS NOT CONNECTED TO THIS 3081 03200007 
x 1LOCP ‘ DEVICES ARE OPTCHAN'D FROM CHANNEL 2 03210007 
RIOCGP'« -SScr stance nt Sseers ac tess Soa a GS ees PRS S SST SSS Sse sees 03220001 
IODEVICE CUNUMBR=*Xx,UNIT=DUMMY,ADDRESS=D00,DEVTYPE=30000001, X03240001 
ERRTAB=223 03250001 


ICP1171 *¥xXWARNINGX® THE ABOVE DEVICE(S) EXCLUDED FROM THE IOCDS 


KLOCPR 0 wenn renner enn nnn ncn nnn rn nn cnn n nnn e ence n cnn 03260001 
-xIOCP CHANNEL E O32700N1 
xIOCP . THIS CHANNEL AND DEVICES ARE NOT CONNECTED TO THIS 3081 03280007 
x1LOCP / DEVICES ARE OPTCHAN'D FROM CHANNEL 2 03290007 
MIOCP 0 toe n nnn nnn en errr nnn nnn nner nnn nn nn rrr 03300001 
IODEVICE ADDRESS=(E10,8),CUKUMBR=*XX , UNIT=3330,MODEL=1 03320002 

ICP117I ¥xXWARNINGXX THE ABOVE DEVICE(S) EXCLUDED FROM THE IOCDS 
IODEVICE ADDRESS=(E40,4), CUNUMBR=X%X, UNIT=3350, X03330001 
OPTCHAN=F 03340001 

ICP1171 X*WARNINGXX THE ABOVE DEVICE(S) EXCLUDED FROM THE 1OCDS 
MIOCPR 00 wenn n nano nena nn enn n= - neo eo nnn n nnn n nn e ncn ne nnn 03350001 
x10CP CHANNEL F 03360001 
*10CP . THIS CHANNEL AND DEVICES ARE NOT CONNECTED TO THIS 3081 03370007 
¥10CP | DEVICES ARE OPTCHAN’D FROM CHANNEL 2 03380007 
MIOCP 00 tonne nono nnn n nn nnn en ener none nnn nnn nnn 03390001 
IODEVICE CUNUMBR=%*x ,UNIT=DUMMY , ADDRESS=F00,DEVTYPE=30000001, X03410001 
ERRTAB=223 03420001 

ICP1171 ¥XWARNINGXX THE ABOVE DEVICE(S) EXCLUDED FROM THE I0CDS 
IODEVICE ADDRESS=(F10,8) , CUNUMBR=XXX , UNIT=3330 ,MODEL=1 03430001 

ICPLI7I ¥*¥WARNINGXX THE ABOVE DEVICE(S) EXCLUDED FROM THE IOCDS 
IODEVICE ADDRESS=(F60,4),CUNUMBR=*XX , UNIT=3350 03440001 

ICP1171 XXWARNING¥X THE ABOVE DEVICE(S) EXCLUDED FROM THE IOCDS 

TOTAL MESSAGES FOR SYNTAX CHECKING: 0013 WARNING MESSAGES: 0013 ERROR MESSAGES: 
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TIME 15.20 DATE 82.035 PAGE 096 
TIME 15.20 DATE 82.035 PAGE 007 
0000 


en 


oo 


PS2 IOCONFIG ID=02 


ID@2 ID MSG1='EXAMPLE CONFIGURATION ' 
CHPID PATH=00,TYPE=BY 
CHPID PATH=((01) , (02) , (03), (94), (05), (06), (07), (0 
CHPID PATH=((09) , (OA), (OB), (OC), (OD), (OE), (OF), (1 
CHPID PATH=((11), (12), (13), (14), (15), (16), (17), (1 
CHPID PATH=((19), (1A), (1B), (1C), (1D), (1E), (1F), (2 
CHPID PATH=((21), (22), (23), (24), (25), (26), (27), (2 
CHPID PATH=((29), 


* 
* 


JO IOC III II FOI I UNIT ADDRESSES 000-OFF KRKKKKKKKREKEKEKRKEKREKKEREKKK 


* 
* 


8) 


0) 
8) 
0) 

8) 


)s 
)s 
)s 
)s 
)s 


( 
(2A) , (2B), (2), (2D), (2E), (2F)) ,TYPE=BL 


TYPE=BL 
TYPE=BL 
TYPE=BL 
TYPE=BL 
TYPE=BL 


CNTLUNIT CUNUMBR=00, UNIT=3811,UNITADD=( (03,4) ) ,SHARED=N, 


PATH=(00) 
IODEVICE UNIT=3211,ADDRESS=(004,3) ,CUNUMBR=00 
IODEVICE UNIT=DUMMY , ADDRESS=003 , CUNUMBR=00 
*TOCP 


PATH=(00) 
*TOCR 
PATH=(00) 


IODEVICE UNIT=3800, FEATURE=CGS2, 
ADDRESS=(O0C,1) , UNI TADD=0C , CUNUMBR=03 


*TOCP 


CNTLUNIT CUNUMBR=02 , UNIT=3203 ,UNITADD=((07,1)) ,SHARED=N, 
IODEVICE UNIT=3203 ,MODEL=4 ,ADDRESS=(007) ,UNITADD=07 , CUNUMBR=02 


CNTLUNIT CUNUMBR=03, UNIT=3800,UNITADD=((O0C,1)) ,SHARED=N, 


CNTLUNIT CUNUMBR=04 , UNI T=3505 ,UNITADD=((12,4)) ,SHARED=N, 


PATH=(00) 
IODEVICE UNIT=3505,ADDRESS=(012,1) ,CUNUMBR=04 
IODEVICE UNIT=3525,ADDRESS=(013,1) , CUNUMBR=04 
IODEVICE UNIT=1288,ADDRESS=(014,1) , CUNUMBR=04 
*TOCP 


CNTLUNIT CUNUMBR=05 , UNIT=3880 , UNI TADD=( (80,16) ) ,SHARED=N, 


PATH=(28,2F) ,PROTOCL=S 


TODEVICE UNIT=3351P,ADDRESS=(080,2) , CUNUMBR=05 ,UNI TADD=80 


= LOC? 


CNTLUNIT CUNUMBR=06 , UNIT=3880 , UNITADD=((CO,32)) ,SHARED=N, 


PATH=(20,2A) , PROTOCL=S 


IODEVICE UNIT=3350P,ADDRESS=(0C0,8) , CUNUMBR=06 , UNI TADD=CO 


*TOCP 


CNTLUNIT CUNUMBR=07 , UNIT=3705, UNITADD=((E0,16),(F1,3)), 
PATH=00 , SHARED=N 
IODEVICE UNIT=2741C,ADDRESS=(0E0, 16) , CUNUMBR=07, TCU=2703, 
ADAPTER=IBM1, FEATURE=AUTOANSR 
IODEVICE UNIT=3705,ADDRESS=(0F1,3) ,CUNUMBR=07 , ADAPTER=CA1 


Figure B-3 (Part 1 of 9). A Combined IOCP and MVS Configuration Program Input Stream 
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* 


* 


* 


* 


B-9 


*TOCP 


* 


* 


* 


*EOCP 
* 
| ox 


Figure 


KKKKKEKKKEKKKKKKKKEKERKE UNIT ADDRESSES 100-1FF KKRKKKEEKEKRKKEKKEREKREKK 
* ; 

* 

*TOCP 


CNYLUNIT CUNUMBR=10,UNIT=3880,UNITADD=( (00,32) ),SHARED=N, 
PATH=(01,0B) ,PROTOCL=S . 

IODEVICE UNIT=3351P,ADDRESS=(100,2) , CUNUMBR=10, UNI TADD=00 

IODEVICE UNIT=3351P,ADDRESS=(110,2) , CUNUMBR=10, UNI TADD=10 


CNTLUNIT CUNUMBR=11,UNIT=3880,UNITADD=( (20,32) ) , SHARED=N, 
PATH=(06,1F) ,PROTOCL=S 

CNTLUNIT CUNUMBR=16, UNI T=3880, UNI TADD=( (20,32) ) ,SHARED=N, 
PATH=(07,29) ,PROTOCL=S 

IODEVICE UNIT=3351P ,ADDRESS=(120,4) ,CUNUMBR=(11,16) 

IODEVICE UNIT=3351P,ADDRESS=(130,4) , CUNUMBR=(11,16) 


CNTLUNIT CUNUMBR=13, UNIT=3880, UNI TADD=( (60,32) ) ,SHARED=N, 
PATH=(10,1A) ,PROTOCL=S 
IODEVICE UNIT=3350P,ADDRESS=(160,4) , UNI TADD=60 , CUNUMBR=13 


KEEKKEKEKEKEKKKEKEKKKKKKKKKE UNIT ADDRESSES 200-2FF RREKKEEKKEKKKKEREKKKRKRKERKKKEKEKE 


CNTLUNIT CUNUMBR=20,UNIT=3880,UNITADD=((20,16)), 
PATH=(13,2F) , PROTOCL=S , SHARED=N 

CNTLUNIT CUNUMBR=21,UNIT=3880,UNITADD=((20,16)), 
PATH=(10,25) , PROTOCL=S , SHARED=N 

IODEVICE UNIT=3380,ADDRESS=(220,16) , UNITADD=20, 
CUNUMBR=(20,21) ,STADET=N, FEATURE=ALTCTRL 


CNTLUNIT CUNUMBR=22 ,UNIT=3880, UNI TADD=((70,16)), 
PATH=(1B) , PROTOCL=S , SHARED=N 

CNTLUNIT CUNUMBR=23,UNIT=3880, UNITADD=((70,16)), 
PATH=(25,17) ,PROTOCL=S , SHARED=N 

IODEVICE UNIT=3380,FEATURE=(ALTCTRL, SHARED) , 
ADDRESS=(270, 16) , UNI TADD=70 , CUNUMBR= (22 , 23) 


B-3 (Part 2 of 9). A Combined IOCP and MVS Configuration Program Input Stream 
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* 


* 


CNTLUNIT CUNUMBR=30,UNIT=3274,UNITADD=((60,32)), 
PATH=(05) , SHARED=N 

IODEVICE UNIT=3270,MODEL=X, ig 
FEATURE=(EBKY3277 , KB78KEY , SELPEN, DOCHAR, AUDALRM, PTREAD) , * 
ADDRESS=(360, 16) , UNI TADD=60 , CUNUMBR=30 


*TOCP 


CNTLUNIT CUNUMBR=31,UNIT=3274 , UNI TADD=((CO,32)), . 
PATH=(QF) , SHARED=N 

IODEVICE UNIT=3270,MODEL=x, g 
FEATURE=(EBKY3277 ,KB78KEY , SELPEN,DOCHAR, AUDALRM) , * 
ADDRESS=(3CO, 16) , UNI TADD=CO , CUNUMBR=31 

IODEVICE UNIT=3270,MODEL=x, . 
FEATURE=(EBKY3277 , KB78KEY , SELPEN, DOCHAR, AUDALRM) , * 
ADDRESS=(3D0,6) , UNI TADD=D0, CUNUMBR=31 

IODEVICE UNIT=3286,MODEL=2, * 
FEATURE=DOCHAR, = 
ADDRESS=(3D6,2) , UNI TADD=D6 , CUNUMBR=31 

IODEVICE UNIT=3270,MODEL=X, ‘ 
FEATURE=(EBKY3277, KB78KEY , SELPEN, DOCHAR, AUDALRM) , 3 


ADDRESS=(3D8,8) , UNI TADD=D8 , CUNUMBR=31 


Figure B-3 (Part 3 of 9). A Combined IOCP and MVS Configuration Program Input Stream 
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+ 


KEKKEKKEKEKKKEEKEKKEKEKEEE UNIT ADDRESSES 400-4FF KRERKEKEKKEKKKEREKERKRERERKERK 
* 
*. 


* 


CNTLUNIT CUNUMBR=48,UNIT=3830,UNITADD=((10,16)), * 
PATH=(@A,14) , SHARED=N 
IODEVICE UNIT=3330,ADDRESS=(410, 16) , FEATURE=SHARED, CUNUMBR=48 


*TOCP 

CNTLUNIT CUNUMBR=49 , UNIT=3880,UNITADD=((20,16)), * 
PATH=(02) , SHARED=N , PROTOCL=S 

CNTLUNIT CUNUMBR=4A,UNIT=3880,UNITADD=((20,16)), ba 
PATH=(0C,16) , SHARED=N, PROTOCL=S 

IODEVICE UNIT=3380, FEATURE=(ALTCTRL, SHARED) ,ADDRESS=(420,16) ,* 
CUNUMBR= (49, 4A) 

*TOCP 

CNTLUNIT CUNUMBR=41,UNIT=3880,UNITADD=((70,16)), ba 
PATH=(0A, 14) ,SHARED=N, PROTOCL=S 

IODEVICE UNIT=3380,FEATURE=(ALTCTRL, SHARED) , * 
ADDRESS=(470, 16) , UNITADD=70, CUNUMBR=41 

*TOCP 

CNTLUNIT CUNUMBR=42 ,UNIT=3830,UNITADD=((A0,16)), * 
PATH=(02,24) , SHARED=N 

CNTLUNIT CUNUMBR=43,UNIT=3830,UNITADD=((A0,16)), * 
PATH=(0C,16) , SHARED=N . 

IODEVICE UNIT=3330,MODEL=11, am 
FEATURE=(SHARED,ALTCTRL) , * 
ADDRESS=(4A0, 16) , UNITADD=A0 ,, CUNUMBR= (42, 43) 

*TOCP 

CNTLUNIT CUNUMBR=44,UNIT=3880,UNITADD=((E0,16)), is 
PATH=(12) ,SHARED=N, PROTOCL=S 

CNTLUNIT CUNUMBR=45,UNIT=3880,UNITADD=((E0,16)), * 
PATH=(0C,28) , SHARED=N, PROTOCL=S 

IODEVICE UNIT=3380,FEATURE=(ALTCTRL, SHARED) , = 
ADDRESS=(4E0,8) , UNI TADD=E0 , CUNUMBR= (44, 45) 

| * 
= 
e 


Figure B-3 (Part 4 of 9). A Combined IOCP and MVS Configuration Program Input Stream 


Z B-12 | IOCP User’s. Guide and Reference 


Fe tabula heeds a. Gel os aeacen Seg ants tase a eee! 


KKKKEKEKKEEKKEKEKKKEKEREKE UNIT ADDRESSES 500-5FF KEKKKEKRKKKEKEKREKREKRKKKREEEKE 
* 
* 
CNTLUNIT CUNUMBR=50,UNIT=3480, UNITADD=((60,16)), * 
PATH=(0E,04) , SHARED=N, PROTOCL=S ; 
IODEVICE UNIT=3480, FEATURE=(SHARABLE) ,OFFLINE=YES, = 
_ ADDRESS=(560,02) ,UNITADD=60 , CUNUMBR=50 
TODEVICE UNIT=3480,O0FFLINE=NO, : 
ADDRESS=(562,04) , UNI TADD=62 , CUNUMBR=50 
IODEVICE UNIT=3480,FEATURE=(SHARABLE) ,OFFLINE=YES, * 
ADDRESS=(566, 10) , UNI TADD=66, CUNUMBR=50 
*TOCP 
CNTLUNIT CUNUMBR=52,UNIT=3803,UNITADD=((80,16)), x 
PATH=(04,0E) , SHARED=Y 
TODEVICE UNIT=3420,MODEL=8,OFFLINE=YES, % 
FEATURE=(9-TRACK,ALTCTRL,OPT1600) , = 
ADDRESS=(580,5) , UNI TADD=80 , CUNUMBR=52 
IODEVICE UNIT=3420,MODEL=5 ,OFFLINE=YES, * 
FEATURE=(9-TRACK,ALTCTRL) , * 
ADDRESS=(585,1) , UNI TADD=85 , CUNUMBR=52 
IODEVICE UNIT=3420,MODEL=8 ,OFFLINE=YES, e 
FEATURE=(9-TRACK,ALTCTRL,OPT1600) , # 


ADDRESS=(586, 10) , UNI TADD=86 , CUNUMBR=52 


* 
* 
KKEKKEKEKEKKEKREKKKEKEKKEKKE UNIT ADDRESSES 600~-6FF KREKKEKEKKREKREKKEKKKREKKKEKKKER 
* 
* 


CNTLUNIT CUNUMBR=60, UNI T=3830,UNITADD=((00,16)), * 
PATH=(06) , SHARED=N 
CNTLUNIT CUNUMBR=61,UNIT=3830,UNITADD=((00,16)), 3 
PATH=(13) , SHARED=N 
IODEVICE UNIT=3330,ADDRESS=(600, 16) , UNITADD=00, a 
FEATURE=(SHARED,ALTCTRL) , CUNUMBR=(60,61) 
*TOCP 
CNTLUNIT CUNUMBR=62 , UNIT=3880,UNITADD=((60,16)), a 
PATH=(0A,1E) , SHARED=N, PROTOCL=S 
CNTLUNIT CUNUMBR=63 ,UNIT=3880,UNITADD=((60,16)), e 
PATH=(14) , SHARED=N , PROTOCL=S 
IODEVICE UNIT=3380, ADDRESS=(660, 16) ,UNITADD=60, = 
FEATURE=(SHARED,ALTCTRL) , CUNUMBR=( 62,63) 
*TOCP 
CNTLUNIT CUNUMBR=64,UNIT=3880,UNITADD=((80,16)), - 
PATH=(0A, 1E) , SHARED=N, PROTOCL=S 
CNTLUNIT CUNUMBR=65 , UNIT=3880, UNITADD=((80,16)), % 
PATH=(14) , SHARED=N, PROTOCL=S 
IODEVICE UNIT=3380,ADDRESS=(680,16) ,UNITADD=80, ms 


FEATURE=(SHARED,ALTCTRL) , CUNUMBR=(64, 65) | 


Figure B-3 (Part 5.of 9). A Combined IOCP and MVS Configuration Program Input Stream 
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B-13 


oo Fa la 


KREKKKKKKKEKKKKRKEKEKRKEREKK UNIT ADDRESSES 700-7FF KREEKKKRKEKRERKERKKEKKEEKKEREER 
* 


CNTLUNIT CUNUMBR=74 ,UNIT=3880,UNITADD=((CO,16)), > 
PATH=(0D) , PROTOCL=S , SHARED=N 

CNTLUNIT CUNUMBR=75,UNIT=3880,UNITADD=((CO,16)), . x 
PATH=(17) , PROTOCL=S , SHARED=N 

IODEVICE UNIT=3380,ADDRESS=(7C0,16) ,UNITADD=CO, . 
FEATURE=(SHARED ,ALTCTRL) ,CUNUMBR=(74,75) 

*TOCP . 

CNTLUNIT CUNUMBR=73,UNIT=2835,UNITADD=((FO,16)), ss 
PATH=(03,0D) , SHARED=N 

IODEVICE UNIT=2305,MODEL=2, : 
ADDRESS=(7F0,1) , UNI TADD=FO , CUNUMBR=73 

IGDEVICE UNIT=2305,MODEL=2, * 


ADDRESS=(7F8,1) ,UNITADD=F8 , CUNUMBR=73 


* 
* 
* 
KEKRKEKKEKRKKEKKKEKEKEKREKEKER UNIT ADDRESSES 800-8FF KRREKKEKEKRKEKEKKEKEKKKEKKEKREKEKE 
* 
* 


* 


CNTLUNIT CUNUMBR=82,UNIT=3880,UNITADD=((70,16)), * 
PATH=(21) , SHARED=N, PROTOCL=S 

CNTLUNIT CUNUMBR=83,UNIT=3880,UNITADD=((70,16)), * 
PATH=(2B,09) , SHARED=N, PROTOCL=S 

IODEVICE UNIT=3380, FEATURE=(SHARED,ALTCTRL) , * 
ADDRESS=(870,8) ,UNITADD=70, CUNUMBR= (82,83) 

*IOCP | 
CNTLUNIT CUNUMBR=85 , UNIT=3880 , UNITADD= ((C0, 16), * 
 PATH=(21,26) ,SHARED=N,PROTOCL=S 

CNTLUNIT CUNUMBR=86, UNIT=3880, UNI TADD= ((c0, 16)), * 
PATH=(2B) , SHARED=N, PROTOCL=S 

IODEVICE UNIT=3380,CUNUMBR=(85,86) , * 
FEATURE=(SHARED,ALTCTRL) , * 


ADDRESS=(8C0,8) ,UNITADD=CO, 


Figure B-3 (Part 6 of 9). A Combined IOCP and MVS Configuration Program Input Stream 
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RRKKEKKKEKKKKEKREKEKKEKKEEE UNIT ADDRESSES Q00-9FF REKRKERKEKREKRKKEKKKRKRERKEKKKREEK 
* 
* 
* 


CNTLUNIT CUNUMBR=90 , UNIT=3880, UNI TADD=((70,16)), i 
PATH=(1D) , SHARED=N, PROTOCL=S 
IODEVICE UNIT=3380, FEATURE=SHARED , ADDRESS=(970,8) , CUNUMBR=90 
*TOCP 


CNTLUNIT CUNUMBR=93 ,UNIT=3880,UNITADD=((DO,16)), * 
PATH=(1D,27) , SHARED=N , PROTOCL=S 
IODEVICE UNIT=3350, FEATURE=SHARED, ADDRESS=(9D0, 16) , CUNUMBR=93 


* 
* 
KKKKREKEKEKKEREKEKRKKKKKKKKKEK UNIT ADDRESSES AOQO-AFF KREKKEKKEKEKEKRERKEKRKERKEKKKKKEEK 
* 
* 


* 


CNTLUNIT CUNUMBR=A2,UNIT=3880,UNITADD=((70,16)), * 
PATH=(1E,28) , SHARED=N, PROTOCL=S 
IODEVICE UNIT=3380, FEATURE=SHARED, ADDRESS=(A70,8) , CUNUMBR=A2 


* 
* 
RKKKKKKKKKEKEKEKRRKRKEKEKKER UNIT ADDRESSES BOQ-BFF KREKKEKEKREKEKKEKRRERERERKEKRERE 
* 
* 


CNTLUNIT CUNUMBR=B2,UNIT=3800 ,UNITADD=((01,4)), ” 
PATH=(04) , SHARED=N 
IODEVICE UNIT=3800,MODEL=3, FEATURE=BURSTER, CUNUMBR=B2, x 


; ADDRESS=(BO1,3) ,UNITADD=01, 
*TOCP 


CNTLUNIT CUNUMBR=B3 ,UNIT=3811,UNITADD=((07,1)), - 
PATH=(08, 09) , SHARED=N 
IODEVICE UNIT=3211,CUNUMBR=B3 , ADDRESS=BO07 , UNI TADD=07 


* 
KRREREKEKEEKRERKERKKEKEKKEKKEK UNIT ADDRESSES COO-CFF KRREKKEKEEKRREKRERERRKERKERKKKE 
* 
* 
* 


CNTLUNIT CUNUMBR=C1 ,UNIT=CTC,UNITADD=((CO,32)),PATH=(15), * 
SHARED=N 

TODEVICE UNIT=CTC,FEATURE=370, . 
ADDRESS=(CCO,32) , UNI TADD=CO, CUNUMBR=C1 , TIMEOUT=N 


Figure B-3 (Part 7 of 9). A Combined IOCP and MVS Configuration Program Input Stream 
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KEKEKRERKEKRKEKRERKEEEREER UNIT ADDRESSES DOO-DFF RRR KKEREEREREKRERKEERERE 
* 
* 
* 


CNTLUNIT CUNUMBR=D0,UNIT=3880,UNITADD=((20,16)), “ 
PATH=(18) , SHARED=N, PROTOCL=S 

CNTLUNIT CUNUMBR=D1,UNIT=3880, UNITADD=((20,16)) , * 
PATH=(22,2C) , SHARED=N , PROTOCL=S . 

IODEVICE UNIT=3380,CUNUMBR=(D0,D1) ,ADDRESS=(D20,8) , = 
FEATURE=(SHARED,ALTCTRL) ,UNITADD=20 

*TOCP 

CNTLUNIT CUNUMBR=D2 ,UNIT=3880,UNITADD=((70,16)), i 
PATH=(18) , SHARED=N, PROTOCL=S 

CNTLUNIT CUNUMBR=D3 ,UNIT=3880 ,UNITADD=((70,16)), % 
PATH=(22,08) , SHARED=N , PROTOCL=S 

IODEVICE UNIT=3380,FEATURE=(SHARED,ALTCTRL) , = 


ADDRESS=(D70,8) , UNITADD=70 , CUNUMBR=(D2 ,D3) 


* 
* 
* 
KRKKEKKEKKERKRKERREKRKRKRKEKRE UNIT ADDRESSES EQO-EFF KKERKKEEKEKKEKREKERKKERERERKEEKRK 
* 
* 
* 


CNTLUNIT CUNUMBR=EO, UNIT=3880,UNITADD=((20,16)), i * 
PATH=(19) , SHARED=N, PROTOCL=S ? 

CNTLUNIT CUNUMBR=E1 , UNIT=3880,UNITADD=((20,16)), * 
PATH=(23,2E),SHARED=N,PROTOCL=S ts | | 

IODEVICE UNIT=3380, ADDRESS=(E20,16) ,UNITADD=20, 
FEATURE=(SHARED,ALTCTRL) , CUNUMBR=(E0, £1) 

*IOCP 

CNTLUNIT CUNUMBR=E2,UNIT=3880, UNITADD=((70,16)), | * 
PATH=(19) , SHARED=N, PROTOCL=S | | 

CNTLUNIT CUNUMBR=E3,UNIT=3880, UNITADD=((70, 16) ) , * 
PATH=(23,2D) , SHARED=N, PROTOCL=S 

IODEVICE UNIT=3380,ADDRESS=(E70,8) ,UNITADD=70, * 


FEATURE=(SHARED,ALTCTRL) , CUNUMBR=(E2, £3) 


Figure B-3 (Part 8 of 9). A Combined IOCP and MVS Configuration Program Input Stream 
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KKEKKKEKKREREKREKEKRREKEKERKEERERERERRREREREKR EERE ERE EREREREKRREKRREERERRREKRER 


KKKKKKE UNITNAMES KEEKKEKK 


KKKEKEKKEKKKEEKEKERKRKERERREEKR EKER EKREEK ERE RKREKEKREKERKREKEKRERKEREREKKKEKER 


SPACE 3 

SYSRDR UNITNAME NAME=SYSRDR,UNIT=(012) 

SYSPR UNITNAME NAME=SYSPR,UNIT=(004 ,006 ,007 ,00C ,B01,B07) 

TAPE UNITNAME NAME=TAPE ,UNIT=( (580,16) ) 

DASD2305 UNITNAME NAME=DRUM,VIO=NO, 
UNIT=(7FO,7F8) 

DASD3350 UNITNAME NAME=DISKAA,VIO=NO, 
UNIT=((0CO,8) , (160,4)) 

DASD3351 UNITNAME NAME=DISKBB,VIO=NO, 
UNIT=((080,2) ,(100,2),(110,2)) 

DASD3380 UNITNAME NAME=DASD,VIO=NO, 
UNIT=( (220,16) , (270,16), 
(660,16) , (680,8) , (688,8), 
(7C0,16) , (900,16), (A70,08) , 
(D20,8) , (D70,8) , (E20, 16) ) 

SYSD3380 UNITNAME NAME=SYSDA,VIO=YES, 
UNIT=((220,16) , (270,16), 
(420,16) , (470,16), (4A0,8), 
(660,16) , (680.8) , (688,8), 
(7C0,16) , (9D0,16) , (A70,08) ) 

SYSQ3380 UNITNAME NAME=SYSSQ,VIO=YES ,UNIT=( (220,16) , (270,16), 
(700,16) ,(9D0,16) , (A70,08) , 
(D20,8) , (D70,8) , (E20, 16) , (E70,8)) 


KREKKKEKREKRKEEREREREREREEREREEKREER ERE EREER ERE ERERRRRREKRKREEKREKEREREKRER 


RKKKKEK NIP CONSOLES REKKKKK 


RAKREKKEKKEREKRKEKEK ERE KERR RRR KERR REE RERERERREERRREREREEREEKERERKEKKKK 


CONSOLES NIPCON DEVNUM=(3D1,361,3C4,3D4, 3D8) 
NIPCON DEVNUM=(360, 363, 3D0,3C7,3C8,3CE) 


Figure B-3 (Part 9 of 9). A Combined IOCP and MVS Configuration Program Input Stream 
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*10CP 
*#10CP 


Figure 


B-18 


1D MSG1='SAMPLE 1OCP FILE' 
CHPID PATH=((00,0,0)), TYPE=BY 
CHPID PATH=((01,1,0)), TYPE=BL 
CHPID PATH=((02,2,0)), TYPE=BL 
CHPID PATH=((03,3,0)), TYPE=BL 
CHPID PATH=((04,4,0)), TYPE=BL 
CNTLUNIT CUNUMBR=000, PATH=00, SHARED=N, UNIT=3811, 
UNI TADD=( (00,8) ) 


CNTLUNIT 


CUNUMBR=001, PATH=00, SHAREDE=N, UNI T=3811, 


UNI TADD=( (08,8) ) 
CNTLUNIT CUNUMBR=002, PATH=00, SHARED=N, UNI T=3505, 
UNI TADD=((10,8) ) 


‘CNTLUNIT CUNUMBR=003, PATH=00, SHAREDEN, UNI T=3274, 


UNI TADD=(( 18,8) ) 


“CNTLUNIT 


CUNUMBR=004, PATH=00, SHARED=N, UNI T=3705, 


UN! TADD=( (30,48) ) 


CNTLUNIT 


CUNUMBR=006, PATH=00, SHAREDEN, UNI T=2955, 


UNI TADD=( (80,8) ) 


CNTLUNIT 


CUNUMBR=007, PATH=00, SHARED=N, UNI T=3705, 


UN | TADD=BO 


CNTLUNIT 


CUNUMBR=010, PATH=01, SHARED=Y, UNI T=3803, 


UN 1 TADD=( (80,8) } 


CNTLUNIT 


CUNUMBR=011, PATH=01, SHARED=Y, UNI T=3803, 


UNI TADD=( (90,8) ) 


CNTLUNIT 


CUNUMBR=020, PATH=02, SHARED=EN, UN! T=3830, 


UNI TADD=( (00, 64) ) 


CNTLUNIT 


CUNUMBR=021, PATH=02, SHARED=N, UNI T=3830, 


UNI TADD=( (40,8) ) 


CNTLUNIT 


CUNUMBR=024, PATH=02, SHARED=N, UNI T=3851, 


UN! TADD=( (AO, 8) ) 


CNTLUNIT 


CUNUMBR=025, PATH=02, SHARED=N, UNI T=2835, 


UN! TADD=((D0,8) ) 


CNTLUNIT 


CUNUMBR=031, PATH=03, SHARED=N, UNI T=3830, 


UNI TADD=( (30,8) ) 


CNTLUNIT 


CUNUMBR=032, PATH=(03,04), SHARED=N, UNI T=3830, 


UNI TADD=( (50,16) ) 


CNTLUNIT 


CUNUMBR=033, PATH=03, SHARED=N, UNI T=CTCA, 


UN! TADD=((DO0,8) ) 


CNTLUNIT 


CUNUMBR=034, PATH=03 , SHARED=N, UNI T=3830, 


UNI TADD=( (40,8) ) 


CNTLUNIT 


CUNUMBR=040, PATH=04, SHARED=N, UNI T=3830, 


UNI TADD=( (00,64) ) 


CNTLUNIT 


CUNUMBR=041, PATH=04, SHARED=N, UNI T=3880, 


UNI TADD=( (40,16) ) 


CNTLUNIT 


CUNUMBR=042, PATH=04, SHARED=N, UNI T=3851, 


UNI TADD=((A0,8)) 


IODEVICE 
IODEVICE 
IODEVICE 
1ODEVICE 
IODEVICE 
1ODEVICE 
IODEVICE 
fODEVICE 


ADDRESS=002, UNI T=3211, CUNUMBR=000 
ADDRESS=00C, UN | T=2540R, CUNUMBR=001 
ADDRESS=00D, UN! T=2540P, CUNUMBR=001 
ADDRESS=00E, UN! T=1403, CUNUMBR=001 
ADDRESS=O0F, UNI T=1403, CUNUMBR=001 
ADDRESS=012, UN! T=3505, CUNUMBR=002 
ADDRESS=013, UNI T=3525, CUNUMBR=002 
ADDRESS=(018, 7), UNI T=3279, MODEL=3, CUNUMBR=003 


DUMMY DEVICE FOR CP ONLY 


IODEVICE 
1ODEVICE 
IODEVICE 
IODEVICE 
IODEVICE 
IODEVICE 
IODEVICE 
1ODEVICE 
IODEVICE 
}ODEVICE 
IODEVICE 
fODEVICE 
IODEVICE 
IODEVICE 
1ODEVICE 
IODEVICE 
IODEVICE 
LODEVICE 
IODEVICE 
IODEVICE 
1ODEVICE 


ADDRESS=01F, UNI T=3215, CUNUMBR=003 
ADDRESS=(030, 16), UNI T=3705, CUNUMBR=004 
ADDRESS=(040, 16), UNI T=3705, CUNUMBR=004 
ADDRESS=(050, 16), UNI T=3705, CUNUMBR=004 
ADDRESS=080, UN! T=2955, CUNUMBR=006 
ADDRESS=0BO, UNI T=3705, CUNUMBR=007 

ADDRESS=( 180, 2), UNI T=3420, MODEL=7, CUNUMBR=010 
ADDRESS=190, UNI T=3420, MODEL=8, CUNUMBR=011 
ADDRESS=( 200, 2), UNI T=3330, MODEL=1, CUNUMBR=020 
ADDRESS=( 208, 2), UNI T=3330, MODEL=1, CUNUMBR=020 
ADDRESS=( 210,48), UNI T=3330, MODEL=1, CUNUMBR=020 
ADDRESS=( 240, 8), UNI T=3350, CUNUMBR=(021, 034) 
ADDRESS=2A0, UN! T=3851, CUNUMBR=024 
ADDRESS=2D0, UNI T=2305, MODEL=2, CUNUMBR=025 
ADDRESS=( 330, 8), UNI T=3330, MODEL=1, CUNUMBR=031 
ADDRESS=( 350, 8), UNI T=3330, MODEL=1, CUNUMBR=032 
ADDRESS=( 358, 2), UN! T=3330, MODEL=11, CUNUMBR=032 
ADDRESS=3D0, UNI T=CTC, CUNUMBR=033, TIMEOUT=N 
ADDRESS=(410,48), UNI T=3330, MODEL=1, CUNUMBR=040 
ADDRESS=( 440, 16), UNI T=3380, CUNUMBR=041 
ADDRESS=4A0, UNI T=3851, CUNUMBR=042 
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DMKOO0010 
DMKO0020 
DMKO0030 
DMKOOO4O 
DMKOO050 
DMKOO060 
*DMKOO0070 
DMKO0080 
*DMKOO0090 
DMKOO100 
*DMKOO110 
DMK00120 
*DMKO0130 
DMKOO140 
*DMKO0150 
DMKOO160 
*DMKO0170 
DMKO0O180 
*DMKO0190 
DMKO0200 
*DMKO00210 
DMKO0220 
*DMKO0230 
DMKOO240 
*DMKO0250 
DMKO0260 
*DMKO0270 
DMKO0280 
*DMKO0290 
DMKO0300 
*DMKO03 10 
DMKO0320 
*DMKO03 30 
DMKO0340 
*DMKO0350 
DMKO00360 
*DMKO0370 
DMKO0380 
*DMKO0390 
DMKOO4OO 
*DMKOO410 
DMKOO420 
*#DMKOO430 
DMKOO44O 
*DMKOO450 
DMKOO46O 
DMKOO470 
DMKOO480 
DMKOO490 
DMKOO500 
DMKO0O510 
DMKO0520 
DMKO0530 
DMKOO540 
DMKO0550 
DMKO0560 
DMKO00570 
DMKO00580 
DMKO0590 
DMKOO600 
DMKO0610 
DMKO00620 
DMKO0630 
DMKOO640 
DMKO0650 
DMKOO660 
DMKO0670 
DMKOO0680 
DMKO0690 
DMKOO0700 
DMKOO710 
DMKO00720 
DMKO0730 
DMKOO740 
DMKO0750 
DMKO00760 
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DMKRIO CSECT DMKO0010 
RDEVICE ADDRESS=002, DEVTYPE=3211, CLASS=(X,A), FEATURE=UNVCHSET DMKO0020 
RDEVICE ADDRESS=00C, DEVTYPE=2540R DMKO0030 
RDEVICE ADDRESS=O0D, DEVTYPE=2540P, CLASS=(X, A) DMKOOO4O 
RDEVICE ADDRESS=O00E, DEVTYPE=1403, CLASS=(X,A), FEATURE=UNVCHSET DMKOO050 
RDEVICE ADDRESS=O0F, DEVTYPE=1403, CLASS=(S), FEATURE=UNVCHSET DMKOO060 
RDEVICE ADDRESS=012, DEVTYPE=3505 DMKO0070 
RDEVICE ADDRESS=013, DEVIYPE=3525, CLASS=(X, A) DMKOO080 
RDEVICE ADDRESS=(018, 7), DEVTYPE=3279, MODEL=3 DMKOOO90 
RDEVICE ADDRESS=0O1F, DEVTYPE=3215 DMKO0100 
RDEVICE ADDRESS=(030,16), DEVTYPE=3705, ADAPTER=BSCA, BASEADD=0B0 DMKO00110 
RDEVICE ADDRESS=(040,16),DEVTYPE=3705, ADAPTER=1BM1, BASEADD=OBO DMKO0120 
RDEVICE ADDRESS=(050, 16), DEVTYPE=3705, ADAPTER=TELE2, BASEADD=0BO DMKO0130 
RDEVICE ADDRESS=080, DEVTYPE=2955 DMKOO140 
RDEVICE ADDRESS=O0B0, DEVTYPE=3705, ADAPTER=TYPEY, MODEL=F4, CPTYPE=EP DMKOO150 
RDEVICE ADDRESS=(180,2), DEVTYPE=3420, FEATURE=DUALDENS, MODEL=7 DMKOO160 
RDEVICE ADDRESS=190, DEVTYPE=3420, FEATURE=DUALDENS, MODEL=8 DMKO00170 
DEVICE ADDRESSES 200, 201, 208, 209 ALLOW ACCESS TO MSC TABLES DMKOO180 
RDEVICE ADDRESS=(200,2), DEVTYPE=3330, MODEL=1 DMKO0190 
RDEVICE ADDRESS=(208, 2), DEVTYPE=3330,MODEL=1 DMKO0200 
RDEVICE ADDRESS=(210,48), DEVTYPE=3330, MODEL=1, FEATURE=SYSVIRT DMK00210 
RDEVICE ADDRESS=(240,8), DEVTYPE=3350, ALTCU=340 DMKO0220 
RDEVICE ADDRESS=2A0, DEVTYPE=3851 DMKO0230 
RDEVICE ADDRESS=2D0, DEVTYPE=2305, MODEL=2 DMKOO240 
RDEVICE ADDRESS=(330,8),DEVTYPE=3330,MODEL=1 DMKO0250 
RDEVICE ADDRESS=(350,8), DEVTYPE=3330, MODEL=1 DMKO0260 
RDEVICE ADDRESS=(358,2), DEVTYPE=3330, MODEL=11 DMKO0270 
RDEVICE ADDRESS=3D0, DEVTYPE=CTCA DMKO0280 
RDEVICE ADDRESS=(410, 48), DEVTYPE=3330, MODEL=1, FEATURE=VIRTUAL DMKO00290 
RDEVICE ADDRESS=(440, 16), DEVTYPE=3380 DMKOO300 
RDEVICE ADDRESS=4UA0, DEVTYPE=3851 DMKO0310 
RCTLUNIT ADDRESS=000, CUTYPE=3811 DMKO00320 
RCTLUNIT ADDRESS=008, CUTYPE=2821 DMKO0330 
RCTLUNIT ADDRESS=010, CUTYPE=3505 DMKOO340 
RCTLUNIT ADDRESS=018, CUTYPE=3274 DMKO00350 
RCTLUNIT ADDRESS=030, CUTYPE=3705, FEATURE=48-DEVICE DMKO00360 
RCTLUNIT ADDRESS=080, CUTYPE=2955 DMKO0370 
RCTLUNIT ADDRESS=OBO, CUTYPE=3705 DMKO0380 
RCTLUNIT ADDRESS=180, CUTYPE=3803 DMKO0390 
RCTLUNIT ADDRESS=190, CUTYPE=3803 DMKOO4OO 
RCTLUNIT ADDRESS=200, CUTYPE=3830, FEATURE=64-DEVICE DMKOO410 
RCTLUNIT ADDRESS=240, CUTYPE=3830 DMKOO420 
RCTLUNIT ADDRESS=2A0, CUTYPE=3851 DMKO0O430 
RCTLUNIT ADDRESS=2D0, CUTYPE=2835 DMKOO44O 
RCTLUNIT ADDRESS=330, CUTYPE=3830 DMKO0450 
RCTLUNIT ADDRESS=340, CUTYPE=3830 DMKOO460 
RCTLUNIT ADDRESS=350, CUTYPE=3830, FEATURE=16-DEVICE, ALTCH=4 DMKOO470 
RCTLUNIT ADDRESS=3D0, CUTYPE=CTCA DMKOO48O 
RCTLUNIT ADDRESS=400, CUTYPE=3830, FEATURE=64-DEVICE DMKOO490 
RCTLUNIT ADDRESS=440, CUTYPE=3880, FEATURE=16-DEVICE DMKO0500 
RCTLUNIT ADDRESS=4A0, CUTYPE=3851 DMKO0510 
RCHANNEL ADDRESS=0, CHTYPE=MULT I PLEXOR DMKO0520 
RCHANNEL ADDRESS=1, CHTYPE=SELECTOR DMKO0530 
RCHANNEL ADDRESS=2, CHTYPE=BLKMPXR DMKOO0540 
RCHANNEL ADDRESS=3, CHTYPE=BL.KMPXR DMKO0550 
RCHANNEL ADDRESS=4, CHT YPE=BLKMPXR DMKO0560 
RIOGEN CONS=01F,ALTCONS=018 DMKO00570 
END DMK00580 
Figure B-5. DMKRIO File for VM/SP and VM/SP HPO System Generation 
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RIO TITLE 'SAMPLE HCPRIO ASSEMBLE FILE! 
RDEVICE DEVNO=002, DEVTYPE=3211, CLASS=(X,A), FEATURE=UNVCHSET 
RDEVICE DEVNO=00C, DEVTYPE=2540R 
RDEVICE DEVNO=00D, DEVTYPE=2540P, CLASS=(X, A) 
RDEVICE DEVNO=00E, DEVTYPE=1403, CLASS=(X,A), FEATURE=UNVCHSET 
RDEVICE DEVNO=00F, DEVTYPE=1403, CLASS=(S), FEATURE=UNVCHSET 
RDEVICE DEVNO=012, DEVTYPE=3505 
RDEVICE DEVNO=013, DEVTYPE=3525, CLASS=(X, A) 
RDEVICE DEVNO=(018, 7), DEVTYPE=3279, MODEL=3 

* VM/XA MIGRATION AID DOES NOT SUPPORT 3215 

THE PRIMARY CONSOLE WILL BE A 3279 INSTEAD 

# RDEVICE DEVNO=01F, DEVTYPE=3215 
RDEVICE DEVNO=(030, 16), DEVTYPE=3705, ADAPTER=BSCA, BASEADD=0B0 
RDEVICE DEVNO=(040, 16), DEVTYPE=3705, ADAPTER=1BM1, BASEADD=0B0 
RDEVICE DEVNO=(050, 16), DEVTYPE=3705, ADAPTER=TELE2, BASEADD=0BO 


* 


# VM/XA MIGRATION AID DOES NOT SUPPORT 2955 
+ 


RDEVICE 
RDEVICE 


DEVNO=080, DEVTYPE=2955 
DEVNO=0B0, DEVTYPE=3705, ADAPTER=TYPEHU, 


MODEL=F4, CPNAME=E 


RDEVICE 
RDEVICE 


DEVNO=(180,2), DEVTYPE=3420, FEATURE=DUALDENS, MODEL=7 
DEVNO=190, DEVTYPE=3420, FEATURE=DUALDENS, MODEL=8 


* DEVICES 200, 201, 208, 209 ALLOW ACCESS TO MSC TABLES 


RDEVICE 
RDEVICE 
RDEV!ICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 


DEVNO=( 200, 2), DEVTYPE=3330, MODEL=1 
DEVNO=(208, 2), DEVTYPE=3330, MODEL=1 
DEVNO=(210,48), DEVTYPE=3330, FEATURE=VUA 
DEVNO=(240,8), DEVTYPE=3350 

DEVNO=2A0, DEVTYPE=3851 

DEVNO=2D0, DEVTYPE=2305, MODEL=2 

DEVNO=( 330,8), DEVTYPE=3330, MODEL=1 
DEVNO=( 350,8) , DEVTYPE=3330, MODEL=1 
DEVNO=( 358, 2), DEVTYPE=3330, MODEL=11 
DEVNO=3D0, DEVTYPE=CTCA 

DEVNO=(410,48), DEVTYPE=3330, FEATURE=VUA 
DEVNO=(440, 16), DEVTYPE=3380 

DEVNO=4A0, DEVTYPE=3851 


* THE PRIMARY CONSOLE IS A 3279-3, NOT A 3215 
RIOGEN CONS=018, ALTCONS=019 


END 


Figure B-6. HCPRIO File for VM/XA Systems Facility 
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HCPOQ0020 
HCPO00030 
HC POOO4O 
HCPO00050 
HCPOO060 
HCPOO0070 
HC POOO080 
HCPOO090 
HCP00100 
HCP00110 
HCP00120 
HCP00130 
HCP00140 
HCP00150 
HCP00160 
HCP00170 


XHCPO00180 


HCP00190 
HCPO0200 
HCPO00210 
HCPO00220 
HCP00230 
HCPOO0240 
HCP00250 
HCPO00260 
HCPO00270 
HCPOQ0280 
HCPO00290 
HCPO00300 
HCP00310 
HCP00320 
HCP00330 
HCPO00340 
HCP00350 
HCP00360 
HCP00370 
HCP00380 


Appendix C. Characteristics of the I/O Interface Timeout 


Function 


On the processor complex, each channel path has an eight-second I/O interface 
timeout function that times the control unit delays in completing I/O tag sequences 
and delays that occur between dependent tag sequences. For additional information 
about these tag sequences, see JBM System/360 and System/370 I/O Interface 
Channel to Control Unit Original Equipment Manufacturer's Information, GA22-6974. 


Malfunctions in control units and I/O devices can cause a channel path to be 
unusable to other control units and I/O devices. The timeout function detects these 
malfunctions. 


When the timeout function is active, any control unit delay in completing an I/O tag 
sequence that exceeds eight seconds or a delay between one sequence and the next 
dependent sequence that exceeds eight seconds results in the channel terminating the 
I/O request to the control unit and generating an interface-control-check 
interruption. For example, the timeout function times the delay between two tag 
sequences used to transfer data between the channel and the control unit. 


When the timeout function is inactive (timeout is inhibited), control unit delays are 
not timed and the channel unconditionally waits until the control unit completes the 
sequence or initiates the next tag sequence. If the control unit fails to complete a 
sequence because of a malfunction, the channel path remains active to the control 
unit. In this case, the channel path is unusable for I/O requests to other control 
units until the failing control unit drops all in-tags (except metering-in and 
request-in) or the channel path Is reset. 


You specify whether the timeout function is to be active or inactive with the 
TIMEOUT parameter, which you specify on the IODEVICE macro instruction or 
the add or alter I/O device screen. 


Note: The TIMEOUT parameter has no effect on delays between channel end and 
device end status presentations when the channel is operating in 370 selector mode. 
The I/O interface timeout function is always inactive during that time. 


The channei times I/O requests as follows: 


e If TIMEOUT =Y is specified, the I/O interface timeout function is active and 
the channel times all I/O tag sequences and delays between dependent tag 
sequences that are initiated by either the channel or the control unit. Some 
examples are: the initial selection sequence resulting from an SIO or SIOF 
instruction, a request-in tag sequence initiated by the control unit to reconnect 
to the I/O interface, and delays between data transfer tag sequences. 


¢ If TIMEOUT=N is specified, the I/O interface timeout function is inactive 
(timeout is inhibited) for: 


— Data transfer tag sequences 

— Delays between data transfer tag sequences 

— Non-reconnect ending status tag sequences 

— Initial selection sequences due to non-reconnect command chaining | 


When the timeout function is inactive, these delays are not timed and the 
channel waits until the I/O device completes the tag sequence or initiates the 
next dependent sequence. 
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When TIMEOUT =N is specified, the I/O interface timeout function is still 
active for: 


— Selection sequences initiated by the control unit 


— Initial selection sequences for the first command after reconnect command 
chaining 


— Any initial selection sequence (such as the SIO, RIO, or TIO instructions) 
when the device is not connected 


Some examples showing when the timeout function is inactive if TIMEOUT =N is 
specified are: 


Example A. Channel initiated sequence (e.g. SIO) 


Initial Data Ending status: 
selection transfer channel end and 
sequence sequences device end sequence 


<---Timed---> < 


Status-in 


Example B. Command chaining control unit initiated reconnection sequence 


Device end Initial Data Ending status: 
reconnect selection transfer channel end and 
sequence sequence sequences device end sequence 


Status-in 


Example C. Split channel end and device end sequence 


Ending status: Ending status: 
channel end <-Delay interval-> device end 
sequence sequence 


Not timed if channel is operating 
in selector mode 
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When a timeout condition is detected, the channel terminates the I/O request to the 
control unit by issuing a selective reset to the control unit and then generating an 
interface-control-check interruption. In 370 mode, if the control unit fails to 
respond to the selective reset and does not drop all in-tags (except metering-in and 
request-in) to the I/O interface within 16 microseconds, the limited channel logout 
that accompanies the interface-control-check indicates an interface-inoperative 
condition. In 370-XA mode, a channel report word (CRW) i is made pending which 
indicates a channel-path-terminal condition. 


If TIMEOUT =N is specified then detection of a timeout condition as a result of an 
interface associated malfunction may not occur ( see the beginning of this appendix 
for a description of sequences which are not timed when TIMEOUT =N is 
specified.) Failure to detect and recover this condition may make various resources 
unavailable to the control program. If continued operation is dependent on the 
availability of these resources, system degradation may be experienced until those 
resources are recovered. Recovery may occur as a consequence of detecting a 
secondary error the 308X may develop from failing to detect the timeout condition. 
Generally, this will not occur and recovery of the resources will require operator 
intervention. For these reasons TIMEOUT =N should be coded only when you 
decide there is a real need which justifies the exposure. 


Timeout Considerations 
Some control units and I/O devices have valid operational conditions that exceed the 
eight-second timeout function limit. If timeout is active when such a condition 
occurs, the channel terminates the I/O request and generates an 
interface-control-check interruption, even though no malfunction exists. For 
example: 


¢ A timeout might occur during a read operation to a tape unit if the tape being 
read is blank. While the tape unit searches for a data byte or the end-of-tape 
mark, it might exceed the eight-second timeout function limit. 


¢ A channel-to-channel adapter between two systems might time out if one system 
attempts to communicate with the other system while the other system is in a 
stopped state. 


Thus, when timeout is active, the channel might terminate an I/O request and 
generate an interface-control-check interruption even though no control unit or I/O 
device malfunction has occurred. 


Note: For a device that can exceed eight seconds with valid operational conditions, 
inhibit the timeout function by specifying TIMEOUT =N on the IODEVICE macro 
instruction. For other IBM I/O devices, it is recommended that you specify or use 
the default TIMEOUT = Y. However, you may chose to specify TIMEOUT = 


Appendix C. Characteristics of the I/O Interface Timeout Function C-3 


‘C-4 IOCP User’s Guide and Reference 


Appendix D. List of I/O Devices and Control Units 


Note: Figure D-1 is a sample list of possible I/O devices. It is not intended to be a 
list of all the possible I/O devices. 


Figure D-! provides a sample list of I/O devices and shows the keyword values you 
specify for the UNIT, MODEL, and TIMEOUT keywords on the IODEVICE 
macro instruction. 


Note: The list does not include all devices that support the 308x processor complex. 
Also, the figure lists the control units that attach the I/O devices and shows the 
keyword values you specify for the UNIT, SHARED, and PROTOCL keywords on 
the CNTLUNIT macro instruction. Notes, which are referenced in the list of 
devices and control units, contain additional information for specific I/O devices and 
control units. 


See “Specifying IOCP Macro Instructions” in Chapter 2 (MVS) or Chapter 3 (VM) 
for a full description of the IODEVICE and CNTLUNIT macro instructions and the 
meanings of the keyword values shown in Figure D-1. 


If you are coding the IODEVICE macro instruction for use with an MVS system 
generation, see OS/VS2 System Programming Library: System Generation Reference 
or MVS/Extended Architecture System Generation Reference for a full description of 
the non-IOCP parameters on the IODEVICE macro instruction. You should also 
refer to this book for the correct keyword value for the UNIT keyword when you 
are using a common deck. If you are coding the IODEVICE macro instruction for 
use with an MVS Configuration Program, see MV S/Extended Architecture: MVS 
Configuration Program Guide and Reference 


See JBM System/370 Input/Output Configurator for information about the 
attachment of I/O equipment used in System/370. 


General Notes: 


- 1. Devices that are supported by IOCP are not necessarily supported by your 
operating system. 


2. On processor complex (such as the 3084 Processor Complex) that you have 
partitioned, if a control unit is attached to multiple channel paths and the 
channel paths are divided between the A side and the B side, the “MULTITAG” 
switch (if the control unit has one) must be set to the on position. 


3. If you use the UNITADD keyword on the IODEVICE macro instruction, you 
must follow the same rules and restrictions that apply to the second and third 
digits of the ADDRESS parameter. 
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4. If you specify the UNITADD parameter on the IODEVICE macro instruction, 
then the second and third digits of the ADDRESS parameter can be different 
from the device’s physical unit address (except for the 3344, 3330V, 3350P, and 
3351P direct access devices) if you follow these rules: 


e All device rules for addressing must be followed. 


¢ For magnetic tapes and local display devices, all device numbers on a 
control unit must be consecutive and the lowest device number must be 
modulo! to the number of devices that can be attached to the control unit. 


¢ For direct access devices: 
— Device numbers on a string must be consecutive (except for the 3344). 


~ The lowest device number on a string of 3330s (and 3350s in emulation 
mode) must be modulo! to the maximum string size. 


a 
| IODEVICE Macro Instruction CNTLUNIT Macro instruction 


UNIT= MODEL= TIMEOUT= Notes UNIT= Model SHARED= PROTOCL= Notes 


Direct Access Devices 


2305 2 Y 1 2835 2 N D 2 
3330 ©1,2,11 =~ 3,4 3830 2 N D 

3880 1,2,11 N D/S 5,6 
3330V—- Y 8 3830 3 N D 
3350V—- y 8,8a 3830 3 N D 
3333. «1,11 Y 7 38302 N D 

3880 1,2,11 N D/S 5,6 
3340—i- Y 4,9 3830 2 N D 

3880 1,2 N D/S 5,6 
3344—iéie Y 9,10 3830 2 N D 

3880 1,2 #2N D/S 5,6 
3350 i= Y 49,11 3830 2 N D 

3880  1,2,11 N D/S 5,6 
3350P_— Y 4,9,11 3880 11 N D/S 56,12 
3351P Y 4,14 3880 21 N D/S 56,15 
3375 - Y 9 3880 1,2 N D/S 5,6 
3380 Y 9 3880 2,3 N D 56,13 

3880 2,3. N S 5,6 

3880 «13 N S 5 

3886-23 N S 5 
3390—i« Y 9,15a 3990 2,3 N S4 


Figure D-1 (Part 1 of 7). IOCP Parameter Values for IODEVICE and CNTLUNIT Macro Instructions 


1 Modulo means that the device number must be evenly divisible by the number of devices in hexadecimal. For 
example, if there are 16 (10 in hex) devices, the last digit of the device number must be 0. If there are 4 devices, the 
last digit must be 0, 4, 8, or C. 


D-2 IOCP User’s Guide and Reference 


NOTES: 


1.For the 2305, specify ADDRESS=(aaa,8). IOCP unconditionally assigns eight 
addresses for the device. 

2.For the 2835, specify UNITADD=((aa,n)), where n=8 or 16 depending on the 
number of 2305 unit addresses required. 

3.* Specify the 3330 Model 2 as MODEL=1. (Note that the 3330 attaches to the 
3830 via the 3333.) 

4,* On the ADDRESS parameter, if you do not specify the number of sequential 
device addresses to be assigned, a default of 2°is used. For the 3350P or 3351P, 
IOCP unconditionally assigns two base addresses if the user specifies 

none or 1. For the 3351P, IOCP unconditionally assigns four base addresses 

if the user specifies 3. 

5.For the 3880, one CNTLUNIT macro instruction must be specified for each 

3880 Storage Director. 

6.Each channel path attaching to the 3880 Model 1, 2, 3, or 11 can operate 
independently in either data streaming mode or offset interlock mode. 

The 3880 has eight channel speed control switches for setting the mode of 
operation. Regardless of the device types attached to the 3880, it is 
recommended that the user: 

(a) set all 3880 channel speed control switches for channel paths attached 

to the processor complex to data streaming mode; 

(b) specify PROTOCL=S on the CNTLUNIT macro instructions for each 3880 

storage director. 

These actions allow the maximum data transfer rates and the use of 

longer cable lengths. The processor complex requires all control units 
attaching a common device to the processor complex to use the same 

interface protocol. Therefore, when both a 3880 and a 3830 attach a 

common device to the processor complex, the user must specify PROTOCL=D 

on both 

(a) the CNTLUNIT macro instruction for the 3830 storage director, and 

(b) the CNTLUNIT macro instruction(s) for the attached 3880 storage director(s). 
In this case, you must set the 3880 channel speed control switches for the 
channel paths that attach the 3880 storage director(s) to the non-data 
streaming mode. 

7.* Specify the 3333 as UNIT=3330. 

8.For the 3330V (virtual volume for MSS), you must also specify the 3851 

on an IODEVICE macro instruction. See the entry for 3851 under "Control Units". 
8a.* For virtual volumes for MSS using 3350 devices as staging devices, specify 
UNI T=3330V. 


* Indicates that the note applies only when you are specifying the IOQDEVICE 
macro instruction for use with an MVS system generation, where the input deck 
contains both MVS system generation macro instructions and I0CP macro 
instructions. 


Figure D-1 (Part 2 of 7). IOCP Parameter Values for IODEVICE and CNTLUNIT Macro Instructions 
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9.* Do not specify the MODEL parameter if the IODEVICE macro instruction is to be 
used as input to MVS system generation. 

10.* Specify the 3344 as UNIT=3340. 

11.Specify UNIT=3350P for each 3350 that is attached to the paging storage 

of a 3880 Model 11. For each 3350P, IOCP defines four device addresses. 

IOCP takes the base address from the ADDRESS parameter. IOCP forms three 
additional addresses by adding the decimal values 8, 16, and 24 to the base 
address. The base address (xyz) must be specified correctly. Bits 3 and 4 of the 
binary values of the byte representing the last two digits of the base 

address must be zeroes. 

(The binary value of the base address xyz must be of the form "nnnn nnnO Onnn".) 
Thus, y must be an even hexadecimal digit (0, 2, 4, 6, 8, A, C, or E) and 

z must be in the range of @ through 7. Specify UNIT=3350 for each 3350 

that is attached to the non-paging storage director of a 3880 Model 11, 

to a 3880 Model 1 or 2, or to a 3830. 

12.Specify the paging storage director of a 3880 Model 11 as UNIT=3880P. 

Also, specify UNITADD=((aa,32)). Bits 3 through 7 of the binary value of 

the byte representing aa must be zeroes. Specify the non-paging storage director 
of a 3880 Model 11 as UNIT=3880. 

13.The 3880 Speed Matching Buffer feature is required. 

14.Specify UNIT=3351P for each 3350 that is attached to the paging storage 
director of a 3880 Model 21. For each 3351P, IOCP defines four device addresses. 
IOCP takes the base address from the ADDRESS parameter. IOCP forms three 
additional addresses by adding the decimal values 4, 8, and 12 to the base 
address. The base address (xyz) must be specified correctly. Bits 4 and 5 of the 
binary value of the byte representing the last two digits of the base address 
must be zeroes. (The binary value of the base address xyz must be of the 

form "nnnn nnnn OOnn".) Thus z must be in the range of 0 through 3. 

15.Specify the paging storage director of a 3880 Model 21 as UNIT=3880P. 

Also, specify UNITADD=((aa,32)). 

Bits 3 through 7 of the binary value of the byte representing aa must be 

zeroes. 

15a.The unit type should indicate the mode of operation for the device. 

If the device is set to 3380 track compatibility mode, use UNIT=3380. 


* Indicates that the note applies only when you are specifying the IODEVICE 
macro instruction for use with an MVS system generation, where the input deck 
contains both MVS system generation macro instructions and IOCP macro 
instructions. 


Figure D-1 (Part 3 of 7). IOCP Parameter Values for LODEVICE and CNTLUNIT Macro Instructions 


D-4 [OCP User’s Guide and Reference 


IODEVICE Macro Instruction =. CNTLUNIT Macro Instruction 


UNIT= MODEL= TIMEOUT= Notes UNIT= Model SHARED= PROTOCL= Notes 


Display Devices 
2250 ‘3 2840 2 
3250 - 3258 - 
3262 3303 3272 1,2 
3274 1B,21B, 
21D,31D 
3277 1,2 3272. 1.2 
3274 18,218, 
1D,21D 
31D 
3272 1,2 
3274 1B,21B, 
1D,21D 
31D 
3274 1B,21B, 
1D,21D, 
31D 
3272 iv 
3274 1B,21B, 
1D,21D 
31D 
3272 12 
3274 1B,21B, 
1D,21D 
31D 
3272 1,2 
3274 1B,21B, 
1D,21D 
31D 
3272 LZ 
3274 1B,21B, 
1D,21D 
31D 
3272 1,2 
3274 1B,21B, 
1D,21D 
31D 
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NOTES: 


16.* Specify the 3250 as UNIT=2250,MODEL=3. 
17.* Specify the 3262, 3287, 3288, and 3289 as UNIT=3284 or UNIT=3286. 
If the 3287, 3288, or 3289 will be used as an MVS/XA operator's console, 
specify UNIT=3286,MODEL=2. 
18.For a 3272 attached to a block multiplexer channel path, the recommended 
specification is SHARED=YB if multiple devices are attached to the control 
unit. SHARED=N is required if a 3272 is attached to a byte multiplexer 
channel path. If SHARED=N is specified and multiple devices are attached 
to the control unit, special error recovery program (ERP) processing is 
required for possible zero sense data. (See IBM 3271 Control Unit, 
3272 Control Unit, 3275 Display Station Description and Programmer's 
Guide, GA23-0060.) Also, this increases the possibility of additional 
overhead in the control program resulting from deferred condition code 1 1/0 
interruptions. If a single device is attached to the control unit, 
SHARED=N can be specified without special ERP support and without increasing 
the overhead in the control program for interruption processing. 
19.For a 3274 attached to a block multiplexer channel path, the recommended 
specification is SHARED=YB if multiple devices are attached to the contro! unit. 
If necessary, you can specify SHARED=N when multiple devices are attached 
to the control unit. (For 370 mode, specify SHARED=N for the control uni 
that interfaces with the master and alternate consoles.) However, specifying 
SHARED=N increases the possibility of additional overhead in the control 
program resulting from deferred condition code 1 1/0 interruptions. If a 
single device is attached to the control unit (as is always the case for 
the 3274 Model 1A), SHARED=N can be specified and does not increase the 
overhead in the control program for interruption processing. If a single 

~ device is attached to the control unit (as is always the case for the 3274 
Model 1A), SHARED=N can be specified and does not increase the overhead in the 
control program for interruption processing. 
20.* Specify the Model 1C as Model 1; Model 2C, as Model 2. 
21.1f the magnetic tape subsystem contains 2 to 4 control units that access the 
same group of magnetic tape units, define each control unit separately. 
Each of the control units must have a different channel path identifier, 
but all of the control units should specify the same address range. 
Specify on the IODEVICE macro instruction that the tape units are attached to al] 
of the control units. (The tape units may actually be only logically 
attached, but they are specified as though they are physically attached.) 
22.* Specify the 2540 with two IODEVICE macro instructions: one with 
UNIT=2540R, the other with UNIT=2540P. 
23.* For the 3203, only the Model 5 is supported, but you specify the Model 5 as 
MODEL=4. 


* Indicates that the note applies only when you are specifying the IODEVICE 
macro instruction for use with an MVS system generation, where the input deck 
contains both MVS system generation macro instructions and IOCP macro 
instructions. 
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IODEVICE Macro Instruction CNTLUNIT Macro Instruction 


UNIT= MODEL= TIMEOUT= Notes UNIT= Model SHARED= PROTOCL= Notes 


Magnetic Tapes 


3420 35455,:. Y 21 3803 142 y D 21 
6,7,8 
3480 - Y - 3480 - N S - 
Magnetic Ink Character Readers 
3890 A,B y - 3890 A,B N D - 
Unit Record Devices 
1403 Ni,N2, Y - 2821 1,2,3,5 N D ~ 
N7 
2501 B1,B2 Y - 2501 B1,B2 N C - 
2540 1 Y 22 2821 1,4,5,6 N D - 
3203 5 Y 23 3203 4 N D - 
3211 - Y 24 3811 1 N D - 
3505 - Y 24 3505 B1i,B2 N D - 
3525 - ¥ 24 3505 B1,B2 N D - 
3546 - Y 24 3540 B1,B2 N D - 
3800 - Y 25,34, 3800 re eee | D/S - 
4245 ~ Y - 4245 - N D - 
4248 - Y ~ 4248 - N D - 
Control Units 
3851 - y 24,28 3851 all N D 28 
Others 
, CTC - sf 29 ~—Ss€T - N D - 
3088 - Y 32 3088 1 N D/S 33 
3174 - y 37 3174 - N - 37 
3838 - Y 24,26 3838 1,2,3 N D/S 27 
3848; Y 24 38481 N D/S - 
Series/1 - Y -  Series/1 - N D - 
| Telecommunications 
uuuuu i= ¥ 30 2701 1 N D - 
3704 - y 24 3704 all N D - | 
uuuuu = Y 31 3704 ~~ all N D “ | 
3705 —si- ¥ 24 3705 al] N D - 
uuuuu = Y 31 3705 ~—s all N D = | 
3725 - Y 24 3725 - N D - 
uuuUuU - Y 31 3725 - N D - 
3791L so - Y 24 3791L 1,2 N D - 
Graphics System 
5081 - Y 35 5088 N D/S 36 
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—-.->-- 


NOTES: 
| 24.* Do not specify the MODEL parameter if the IODEVICE macro instruction is to 
be used as input to MVS system generation. 
25.Specify TIMEOUT=Y when IBM-supplied programs are used with the 3800. 

Non-IBM programs might require TIMEQUT=N for the 3800 because I/0 requests 
might require more than eight seconds to complete. 

26.For the 3838, specify ADDRESS=(aa0,8). The last digit of the unit 

address must be 0; and IOCP unconditionally assigns eight unit addresses 

to the device. 

27.For the 3838, specify UNITADD=((a0,8)). (Note 24 contains related 
information.) 

28.For the 3330V (virtual volume for MSS), you must also specify the 3851 

on an IODEVICE macro instruction. See the entry for 3851 under "Control Units". 
29.For the channel-to-channel adapter (CTC), you may choose to specify TIMEOQUT=N 
because I/0 sequences on the CTC might require more than eight seconds to 
complete. Because TIMEOQUT=N, the CTC cannot be attached to a byte multiplexer 
channel path. 

30.* On the UNIT parameter, you can specify any device or line that is 
attached to the 2701. 

31.* On the UNIT parameter, you can specify any device or line that is 
attached to the 3704,3705 and 3725. (This applies only to EP mode and 

byte multiplexer mode.) 

32.For a 3088, specify ADDRESS=(aaQ,n), where n=32 or 64 depending on the 
number of unit addresses required. 

33.For a 3088, specify UNITADD=(a0,n), where n=32 or 64 depending on the 
number of unit addresses required. Note 32 contains related information. 
34.Attach the 3800 to a block multiplexer channel (TYPE=BL) for optimum 
system performance. 

35.If you are using one combined input deck, the UNIT parameter must be 
respecified. When you are using the 5081 in a 3250-compatibility mode 

(for example when attached to a 3258), specify the 5081 as UNIT=2250, 

MODEL=3. When you are using the 5081 in full function mode, specify the 

5081 as UNIT=HFGD. (For more information, see Graphics Access Method/System 
Product: Initialization, Resource Definition, and Customization, SC33-0141-0.) 
36.The 5088 device can run in either D.C. interlock protocol or data streaming 
protocol, depending on the channel. Ensure that the interface protocol 
specified matches the protocol specified in the 5088. 

37.A 3174 with the token ring feature requires, during IPL, an address that 
ends with "Q." 


* Indicates that the note applies only when you are specifying the IODEVICE 
macro instruction for use with an MVS system generation, where the input deck 
contains both MVS system generation macro instructions and IOCP macro 
instructions. 
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Glossary 


The following terms are defined as they are used in this 
book. If you do not find the term you are looking for, 
refer to the Index or to the Vocabulary for Data 
Processing, Telecommunications, and Office Systems, 
GC20-1699. 


channel path. A connection between a processor and 
control unit along which signals and data can be sent to 
perform I/O requests. Analogous to channel. 


channel set. A collection of channels that can be 
addressed by one of the processors of a processor 
complex. 


data streaming. The I/O interface protocol that 
operates at the rate governed by the control unit. This 
protocol does not require the demand response. 

(See D. C. interlock.) 


D. C. interlock. The I/O interface protocol that is the 
standard I/O interface and requires a demand response. 


device address. Three hexadecimal digits that uniquely 
identify an I/O device in 370 mode. 


device number. Three hexadecimal digits that uniquely 
identify an I/O device in 370-XA mode. 


1/O configuration. The collection of channel paths, 


control units, and I/O devices that attaches to the 
processor complex. 
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I/O engine. An integrated unit of hardware (consisting 
of one channel processing element, one to three data 
server elements, and 8, 16, or 24 interface adapter 
elements) that performs the I/O operations to all 
attached I/O devices. Note: There are two I/O engines 
in a 3084 Processor Complex. 


input/output configuration data set (IOCDS). The data 
set, located in the processor controller file, that contains 
the I/O configuration definition. 


input/output configuration program (IOCP). An 
IBM-supplied program that creates the I/O 
configuration definition (IOCDS) based on user-defined 
input. 

IOCDS. Input/output configuration data set. 

IOCP. Input/output configuration program. 

logical control unit. A logical representation of (1) a 
control unit that does not share devices. or (2) two to 


four control units that do share devices. 


uniprocessor. A processor complex that physically 
contains only one processor. 


unit address. The last two digits of a device address or 
a device number. 
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index 


A 


A keyword 

on REPORT option 2-29 
AB keyword 

on REPORT option 2-29 
ABx keyword 

on WRTCDS option 2-26 
add channel path menu 4-15 
add control unit menu 4-18 
add I/O device menu 4-21 
ADD screen command 4-6 
add selection menu 4-11 
ADDRESS keyword 


on IODEVICE macro instruction 2-17, 3-18 


ADD=value screen command 4-6 
alter channel path menu 4-16 
alter control unit menu 4-19 
alter 1/O device menu 4-22 
ALTER screen command 4-6 
alter selection menu 4-12 
ALTER = value screen command 4-6 
authorized IOCP program 2-32, 2-33, 2-34 
Ax keyword 

on REPORT option 2-29 

on WRTCDS option 2-26 


B keyword 

on REPORT option 2-29 
BL keyword value 2-8, 3-10 
block multiplexer channel 2-8, 3-10 
BOTH keyword 

on REPORT option 2-29 
BOTHRPT option on [OCP command 3-35 
build [OCDS from cards menu 4-23 
burst mode 2-8, 3-10 
Bx keyword 

on REPORT option 2-29 

on WRTCDS option 2-26 
BY keyword value 2-8, 3-10 
byte multiplexer channel 2-8, 3-10 
byte-interleave mode 2-8, 3-10 


Cc 


card-image input 
introduction 1-4 
IOCP macro instructions 2-2 
CD0 keyword 
on REPORT option 2-29 
CDORPT option on [OCP command 3-35 
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CDI keyword 
on REPORT option 2-29 


CDIRPT option on IOCP command 3-35 


CE 1-6, 2-33, 3-47, 4-32 


CHANNEL macro instruction 
channel number 2-7, 3-8 
channel path 

alter menu 4-16 
channel path display 4-14 
channel path selection 

for 370-XA mode 1-13, I-14 


on a 3084 Processor Complex 


preferred path 1-13 

rotation algorithm 1-14 
channel paths 

add menu 4-15 

configuration report 

corresponding side (A or B) 

delete menu 4-13 

display menu 4-14 

introduction {-1 


1-19, 2-6 


1-14 


5-5, 5-14 


1-] 


specifying on CHPID macro instruction 


summary of restrictions 
channel set 2-7, 3-9 


channel set switching 2-8, 3-10 


channel subsystem 1-1 
CHPID macro instruction 


2-4, 3-6 


correspondence with DMKRIO file 
correspondence with HCPRIO file 


description 2-6, 3-8 
examples 2-8, 3-10 
for 370-XA mode 1-6 
format 2-6, 3-8 
introduction 1-4 


with MVS system generation 


chpid number 2-6, 3-8 
CMS/DOS 3-37 
CNTLUNIT macro instruction 


1-19 


correspondence with DMKRIO file 
correspondence with HCPRIO file 


description 2-10, 3-11 
examples 2-14, 3-16 
format 2-10, 3-11 
introduction 1-4 
keyword values D-1 
logical control units 


with MVS system generation 


codes 
return 2-31, 3-46 
wait state 4-38 
commands, screen 4-6 


2-10, 3-11 


1-19 


2-6, 3-8 


3-3 


3-5 


3-3 


3-5 


command = value form of screen command 4-6 
comment cards, IOCP 2-2, 2-24, 3-2, A-1 


Index 


X-3 


compatibility considerations 1-7 DISPLAY = value screen command 4-7 


configuration data DMKRIO file 3-3 
initially defining 2-32, 3-47 DMSICP module 3-30 
introduction 1-1 DSE (data server element) 1-2, 1-3, 2-4, 3-6 
specifying 1-4, 2-2 dumping IOCP storage 4-36 
subsequently defining 2-33, 3-48 D. C. interlock protocol 
updating 2-33, 3-48, 4-33 on PROTOCL=D parameter 3-12 
configuration reports D.C. interlock protocol 
conditions for producing ‘5-2 on PROTOCL=D parameter 2-11 
description 5-1 
examples 5-5, 5-8, 5-11, 5-14 
heading, ID macro instruction 2-15, 3-17 E 
JCL example 2-28 end [OCP menu 4-31 
menu screen 4-25 END screen command 4-7 
producing 2-1, 2-28, 3-30, 3-31 executing IOCP 
control unit display menu 4-17 MVS version 1-18, 2-1 
control unit types 1-17 stand-alone version 1-25, 4-1 
control units VM version 1-23, 3-1 
add menu 4-18 
alter menu 4-19 F 


delete menu 4-13 
display menu 4-17 : 
introduction 1-1 fileid 3-32 


specifying on CNTLUNIT macro instruction 2-10, for 370-XA mode 
3-11, D-1 channel path selection 


rotation algorithm 1-14 


FILEDEF command 3-32 


specifying on IODEVICE macro instruction D-1 


CUNUMBR keyword 3-20 format of macro instruction 
specifying on the IODEVICE macro instruction oe 3-18 
on CUNUMBR parameter 2-18 f ¢ = 
summary of restrictions 2-4, 3-6 se tne ates MStEueHeys 
types 1-17 . 
CUNUMBR keyword CNTLUNIT 2-10, 3-11 
on CNTLUNIT macro instruction 2-10, 3-11 Paneer 16 
on IODEVICE macro instruction 2-18, 3-20 1 eee : A-I 
customer name for the IOCDS 2-15, 3-17, 4-30 ESO oe 7 
D keyword generating an LOCDS 
on PROTOCL keyword 2-11 PANS Version) tel8e2 29 
D keyword value JCL examples 2-26 
data server element (DSE) 1-2, 1-3, 2-4, 3-6 pene Ae 3-1 
data streaming protocol ates 
on PROTOCL=S parameter 2-11, 3-13 VM/SP histone 3-30 
on PROTOCL=S¢4 parameter 2-11, 3-13 generating an [OCDS on a new processor 
DELETE screen command 4-7 complex 4-32 
delete selection menu 4-13 
DEVCXA frame 5-2 H 


Device Configuration Frame 5-2 
DIAGNOSE X’80’ 3-30 

DISK option on IOCP command 3-36 
display channel path menu 4-14 


HALT EXECUTION 3-41 
HCPRIO file 3-5 


display control unit menu 4-17 | 

display I/O device menu 4-20 ID macro instruction 
DISPLAY screen command 4-7 description 2-15, 3-17 
display selection menu 4-10 example 2-15, 3-17 


format 2-15, 3-17 
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ID macro instruction (continued) 
introduction 1-4 
on configuration reports 5-3 
with MVS system generation 1-19 
ID1l=,1D2= 2-15, 3-17, 5-3 
IGNORE option 
condition for coding 2-29 
on build IOCDS from cards menu 4-23 
on PARM parameter of EXEC statement 2-24 
on the IOCP command 3-34 
input to [OCP 
introduction 1-4 
IOCP macro instructions 2-2, 3-2 
integrated processor controller file 4-1 
invoking stand-alone IOCP 4-3 
IOCDS 
compatibility considerations 1-7 
configuration reports 2-28, 3-30, 5-1 
customer name 2-15, 3-17, 4-30 
generating an [OCDS 
MVS version 1-18, 2-23 
stand-alone version 1-25, 4-23, 4-32 
VM version 1-23, 1-25, 3-1 
VM/SP version 3-30, 3-43 
initially defining 2-32, 3-47 — 
levels 1-6 
overview 1-5 
read LOCDS from the processor controller file 
menu 4-27 
subsequently defining 2-33, 3-48 


write IOCDS to the processor controller file 4-29 


write-protecting 1-5 
370-XA mode 1-8 

IOCDSM frame 1-5, 2-15, 3-17. 

IOCP 
card image input 1-4 
CMS IOCP command 3-30 
codes 3-46, 4-38 
comment card 2-2, 3-2 
compatibility considerations 1-7 
configuration reports 5-1 
console input 1-4 
dump function 4-36 
executing the MVS version 2-1 
executing the stand-alone version 4-1 
executing the VM version 3-1 
functions 2-23, 3-30 
introduction 1-1 
keyword values D-1 
levels 1-6 
macro instructions 2-2, 3-2 
messages 6-1 
MVS system generation 1-19 
return codes 2-31, 3-46 
specifying macro instructions 2-2, 3-2 
version number on the reports 5-3 
versions v, 1-18 
wait state codes 4-38 


IOCP (continued) 
370-XA mode 1-8 
IOCP command 3-32 
BOTHRPT option 3-35 
CDORPT option 3-35 
CDIRPT option 3-35 
DISK option 3-36 
IGNORE option 3-34 
LINECOUN option 3-36 
NOIGNORE option 3-34 
NOPRINT option 3-36 
NOTERM option 3-36 
NOWARN option 3-37 
NOWRT option 3-34 
NOWRTCDS option 3-34 
PRINT option 3-36 
RPTA option 3-35 
RPTAB option 3-36 
RPTAx option 3-35 
RPTB option 3-36 
RPTBx option 3-35 
TERMINAL option 3-36 
WABx option 3-35 
WARNING option 3-36 
WBx option 3-34 
WRT option 3-34 
WRTABx option 3-35 
WRTAx option 3-34 
_WRTBx option 3-34 
WRTCDS option 3-34 
IODEVICE macro instruction 
correspondence with DMKRIO file 3-3 
correspondence with HCPRIO file 3-5 
description 3-18 
examples 2-20, 3-28 
format 3-18 
introduction 1-4 
keyword values D-1 
IODEVICE macro instruction, IOCP 
description 2-16 
format 2-16 
with MVS system generation 1-19, 2-16 
LODEVICE macro instruction, MVS system 
generation 1-19, 2-16 
1/O configuration 
definition requirements 1-1 
process 1-4 
I/O configuration data . 
channel path configuration for a non-3084 1-2 
channel path configuration for a 3084 1-3 
specifying 1-4, 3-2 aa 
1/O device 
add menu 4-21 
I/O device display menu 4-20 
I/O devices 
alter menu 4-22 
configuration report 5-8 
delete menu 4-13 


‘Index 


X-5 


1/O devices (continued) 
display menu 4-20 
introduction 1-1 
specifying on IODEVICE macro instruction 2-16, 
3-18, D-1 
summary of restrictions 2-5, 3-7 


J 


JCL statement (MVS version) 
introduction 1-18 

JCL statements (MVS version) 
generating an IOCDS 2-24 
introduction 2-1 
producing configuration reports 2-28 


K 


keyword values 
on IODEVICE and CNTLUNIT macro 
instructions D-1 


L 


layout of menu screens 4-5 
levels of the IOCDS 1-6 
LINECOUN option on IOCP command 3-36 
LINECOUNT option 
on PARM parameter of EXEC statement 2-26, 
2-29 
logical control unit 
CNTLUNIT macro instruction 2-10, 3-11 
configuration report 5-11 
definition 1-9 
examples 1-10, 1-12 
introduction 1-9 
restrictions 1-9 


M 


macro instruction 
{OCP 
CHPID 2-6, 3-8 
CNTLUNIT 2-10, 3-11 
ID 2-15, 3-17 
IODEVICE 2-16, 3-18 
MVS system generation 
CHANNEL 2-6— 
IODEVICE 2-16 
macro instructions 
listing of input B-1 
rules for coding A-] 
menu numbers (primary menu) 4-8 
MENU screen command 4-7 
menu screens 
add channel path 4-15 
add control unit 4-18 
add I/O device 4-21 
add selection 4-11 
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menu screens (continued) 
alter channel path 4-16 
alter control unit 4-19 
alter I/O device 4-22 
alter selection 4-12 
build IOCDS from cards 4-23 
configuration reports 4-25 
delete selection 4-13 
display channel path 4-14 
display control unit 4-17 
display I/O devices 4-20 
display selection 4-10 
end IOCP 4-31 
layout of screens 4-5 
primary menu 4-8 
read IOCDS from the processor controller file 4-27 
service aid facility 4-25 © 
write IOCDS to the processor controller file 4-29 
messages 
DMSICP prefix 6-46 
messages, [OCP 
ICP prefix 6-1 
method of executing IOCP 
stand-alone version 4-32 
methods of executing IOCP 
MVS version 2-32 
VM version 3-47 
MODEL keyword 
on IODEVICE macro instruction 2-18, 3-23 
MSGI keyword 
on ID macro instruction 2-15, 3-17 
MSG2 keyword 
on ID macro instruction 2-15, 3-17 
MVS System Generation 1-19 
MVS version of [OCP 
executing 2-23 
JCL statements 2-24, 2-28 
methods of executing 2-32 
overview 1-18 
using 2-1 
MVSCP 
relationship to [OCP 1-21 


N keyword 

on SHARED parameter 2-12 

on TIMEOUT parameter 2-19 
N keyword value 

on SHARED keyword 3-14 

on TIMEOUT keyword 3-25 
NO keyword 

on IGNORE parameter 2-25 

on WRTCDS option 2-26 
NOIGNORE option on IOCP command 3-34 
NOPRINT option on [OCP command 3-36 
NOTERM option on IOCP command 3-36 


NOWARN option on [OCP command 3-37 
NOWRT option on IOCP command 3-34 
NOWRTCDS option on IOCP command 3-34 


O 


OPTCHAN keyword 
on IODEVICE macro instruction 2-17, 2-24 


Pp 
PARM option 
producing configuration reports 2-28 
PARM options 
generating an IOCDS 2-1 
on EXEC statement 1-18, 2-1 
PATH keyword 
on CHPID macro instruction 2-6, 3-8 
on CNTLUNIT macro instruction 2-11, 3-12 
on IODEVICE macro instruction 2-18, 3-24 
power-on reset 1-5, 1-20, 1-24, 1-26 
preferred path 
introduction 1-13 
on IODEVICE macro instruction 2-18, 3-24 
primary menu 4-8 
print IOCDS configuration reports with Service Aid 
Facility 4-25 
PRINT option on IOCP command 3-36 
privilege class 3-40, 3-41 
processor complex 
channel path configuration 1-2, 1-3 
definition v 
side A 1-1 
side B_ 1-1 
3084 Processor Complex . 1-1 
processor controller 
with MVS version Of IOCP 
generating an IOCDS 2-23, 2-27 
overview 1-18 
producing configuration reports 2-28 
with stand-alone version of IOCP 
executing IOCP 4-8 
with END command 4-3] 
with read IOCDS from the processor controller 
file menu 4-27 
with write IOCDS to the processor controller file 
menu 4-29 
with the MVS version of IOCP 
overview 1-25 
with VM/SP version of IOCP 
generating an IOCDS = 3-43 
overview 1-23 
producing configuration reports 3-31 
PROTOCL keyword 
on CNTLUNIT macro instruction 2-11, 3-12 


R 


read LOCDS from the processor controller file 
menu 4-27 
replacing an IOCDS by using card-image input 4-33 
REPORT option 
~ condition for coding 2-29 
on PARM parameter of EXEC statement 2-28 
RESHOW screen command 4-7 
restarting [OCP 4-4 
return codes 2-31, 3-46 
rotation algorithm 
examples 1-14 
introduction 1-14 
RPTA option on IOCP command 3-35 
RPTAB option on IOCP command 3-36 
RPTAx option on IOCP command 3-35 
RPTB option on IOCP command 3-36 
RPTBx option on IOCP command 3-35 
rules for coding macro instructions A-] 


Ss 


S keyword 
on PROTOCL keyword 2-11, 3-13 
screen commands 4-6 
service aid facility 4-25 
service support console 
— executing IOCP 4-1 
input toIOCP 1-4 
starting IOCP 1-25, 4-3 
SHARED keyword 
on CNTLUNIT macro instruction 2-11, 3-13 
side A 
definition 1-1 
side B 
definition 1-1 
single processor mode 3-38, 3-49 
specifying IOCP macro instructions 2-2, 3-2 
specifying I/O configuration data 1-4 
stand-alone version of IOCP 
methods of executing 4-32 
overview 1-25 
using 4-1 
starting and ending IOCP 4-3 
steps IOCP performs to build an IOCDS 4-35 
syntax of macro instruction 
CNTLUNIT 2-10 
ID 2-15 
IODEVICE 2-16 
syntax of macro instructions 
CHPID 2-6, 3-8 
CNTLUNIT 3-11 
ID 3-17 
IODEVICE 3-18 
rules for coding A-1 
SYSIML CLEAR | 1-5, 1-20, 1-24, 1-26 


Index X-7 


SYSIN FILEDEF 3-32 W 
SYSPRINT FILEDEF 3-32 


system console WABx option on [OCP command 3-35 


executing IOCP 1-4, 4-1 wait state codes 4-38 
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